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Preface 


This manual is one of a series that instructs and guides you in the 
use of the SPERRY UNIVAC Operating System/3 (OS/3). It 
describes the purpose and use of the ESCORT programming 
language. 

The manual has four parts: 


= Part 1 deals with the general concepts of ESCORT and how to 
call ESCORT. 


= Part 2 deals with tutorial mode, which aids the beginning 
user. 


= =«Part 3 deals with program mode and the various commands 
and statements it includes. 


= Part 4 deals with ESCORT programming considerations and 
includes relevant appendixes and a glossary. 


The parts contain the following: 
= PART 1. WHERE TO BEGIN 
- Section 1. Introduction to ESCORT 


Describes the operating modes and the basic language 
concepts of ESCORT. 


- Section 2. Logging on the System and Calling ESCORT 


Describes how to gain entry into OS/3 and call ESCORT. 
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es PART 2. CONCEPTS OF TUTORIAL MODE 


Section 3. Interactive Tutorial Mode 


Describes how to use the tutorial mode of operation and 
gives sample sessions that help describe this learning 
tool. 


ws PART 3. CONCEPTS OF PROGRAM MODE 


Section 4. Interactive Program Mode 


Describes the program mode of operation (direct entry 
and screen menu methods) and gives sample sessions for 
the most commonly used and the required screen menus. 


= PART 4. SPECIFICS OF PROGRAM MODE 





Section 5. ESCORT Commands 

Describes the types of commands and their functions. 
Section 6. ESCORT Files and Structures 

Describes the two different types of files and their access 
methods, how to build a file structure, and how to 
compose structure statements. 


Section 7. Programs and Program Statements 


Describes the different program statements and their 
associated clauses. 


Section 8. Jobs 


Describes jobs and how to enter and manipulate them 
with ESCORT commands. 


Section 9. How to Create Customized Input/Output 
Forms 


Tells how to create customized forms for input and 
output. 


Appendix A. Program Statement Formats 


Lists the complete format of each program statement. 
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- Appendix B. Reserved Words 
Lists reserved words and explains their use. 
- Appendix C. Function Key Use 


Lists the function keys and their actions under the 
processing modes in ESCORT. 


- Appendix D. Programming Considerations 

Explains some special conventions used with ESCORT. 
- Appendix E. Error Messages 

Lists error messages by category. 


- Appendix F. SYSGEN Requirements and System 
Considerations 


Describes system generation requirements and system 
recommendations for efficient ESCORT operation. 


- Appendix G. Custom Formatting Using Structures 


Gives an example of custom formatting using structures 
you design to suit your output. 


This manual includes brief explanations of relevant OS/3 system 
concepts but, for the most part, assumes you are familiar with 
system concepts and operations. If you are not, refer to the 
appropriate OS/3 manual. 


The current versions of the following manuals are helpful to the 
ESCORT user: 


System 80 

= System 80 operations handbook, UP-8859 

= Consolidated data management concepts and _ facilities, 
UP-8825 

m Interactive services commands’ and § ffacilities user 
guide/programmer reference, UP-8845 

= Screen format services concepts and facilities, UP-8802 

m= Job control user guide, UP-8065 

= System installation user guide/programmer _ reference, 


UP-8859 
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a se 
a File cataloging concepts and facilities, UP-8860 @ 
Series 90 Systems 
= 90/25 operations handbook, UP-8511 
m 90/30, 90/40 operations handbook, UP-8072 


m System installation user guide/programmer _ reference, 
UP-8074 


= Consolidated data management concepts and facilities, 
UP-8825 


m Interactive services commands’ and facilities user 
guide/programmer reference, UP-8845 


= Screen format services concepts and facilities, UP-8802 


m= Job control user guide, UP-8065 








UP-8855 Rev. 1 SPERRY UNIVAC OS/3 
; pet ESCORT 





PAGE STATUS SUMMARY 
PREFACE 
CONTENTS 
PART 1. WHERE TO BEGIN 


r 1. INTRODUCTION TO ESCORT 

1.1. AN EASY-TO-USE LANGUAGE 

1.2. MODES OF OPERATION 
Interactive Tutorial Mode 
Interactive Program Mode 

1.3. CONCEPTS OF ESCORT 

1.4. HOW ESCORT WORKS 
Program Mode 
Tutorial Mode 
HELP 

1.5. STATEMENT FORMAT CONVENTIONS FOR SCREENS 


1.6. WHERE TO GO FROM HERE 


2. LOGGING ON THE SYSTEM AND CALLING ESCORT 
2.1. PREREQUISITES 
& 2.2. LOGGING ON THE SYSTEM 


2.3. HOW TO CALL ESCORT 


Contents 1 


Contents 


2-2 


2-4 








UP-8855 Rev. 1 SPERRY UNIVAC OS/3 Contents 2 


ESCORT 
5 SSS] 2 ee 





PART 2. CONCEPTS OF TUTORIAL MODE ] 


3. INTERACTIVE TUTORIAL MODE 





3.1. WHY USE TUTORIAL MODE? 3-1 
3.2. THINGS YOU NEED TO DO BEFORE ENTERING TUTORIAL MODE 3-2 
Step 1: Make Sure the Files You Need Are Cataloged 3-2 
Step 2: Enter ESCORT 3-2 
3.3. ENTERING TUTORIAL MODE 3-2 
3.4, ENTERING DATA . 3-4 
3.5. CREATING A DATA FILE 3-4 
3.6. CHANGING DATA 3-12 
3.7. CHANGING DATA FROM THE WORKSTATION 3-12 
3.8. RETRIEVING DATA (SELECT) 3-17 
3.9. SELECTING DATA BASED ON CONDITIONS 3-17 
3.10. SORTING DATA 3-25 
3.11. SORTING DATA BY FIELD NAMES 3-26 
3.12. DELETING DATA FROM THE WORKSTATION 3-31 


PART 3. CONCEPTS OF PROGRAM MODE 


4. INTERACTIVE PROGRAM MODE 
4.1. WHY USE PROGRAM MODE? 4-1 


4.2. THINGS YOU NEED TO DO BEFORE ENTERING PROGRAM MODE 4-2 
Step 1: Make Sure the Files You Need Are Cataloged 4-2 
Step 2: Enter ESCORT 4-2 
Step 3: Create a Structure 4-2 





UP-8855 Rev. 1 


4.3. 


4.4. 


4.5. 


4.6. 


4.7. 


4.8. 


4.9. 


4.20. 


4.21. 


4.22. 


SPERRY UNIVAC OS/3 
ESCORT 


PROGRAM MODE - THE SCREEN MENU METHOD 


USING THE SCREEN MENU METHOD TO CREATE TWO KINDS 
OF DATA ENTRY PROGRAMS 


CREATING A NEW DATA FILE 
EXTENDING AN EXISTING DATA FILE 


USING THE SCREEN MENU METHOD TO CREATE THREE KINDS 
OF DATA CHANGE PROGRAMS 


CHANGE DATA FROM THE WORKSTATION 
CHANGE DATA BY ASSIGNING NEW FIELD VALUES 


CHANGE DATA OF MASTER FILE BY REPLACING WITH 
MATCHING FILE DATA 


USING THE SCREEN MENU METHOD TO CREATE THREE KINDS 
OF SELECT DATA PROGRAMS 


SELECT DATA WITH CONDITIONS 
SELECT DATA FROM THE WORKSTATION 
SELECT DATA FROM ANOTHER FILE 


USING THE SCREEN MENU METHOD TO CREATE A DELETE 
DATA PROGRAM 


DELETE DATA BY WORKSTATION INQUIRY 
DELETE DATA BY FILE MATCHING 
DELETE DATA BASED ON IF CONDITIONS 


USING THE SCREEN MENU METHOD TO CREATE TWO KINDS 
OF SORT DATA PROGRAMS 


SORT DATA BY DESIGNATING FIELD NAMES 
SORT DATA BY MATCHING STRUCTURE FIELD 
PROGRAM MODE - THE DIRECT ENTRY METHOD 


Direct Entry of Program Statements 
Direct Entry of Clauses 


Contents 3 


4-3 


4-23 


4-30 


4-30 


4-36 


4-4) 


4-45 


4-45 


4-48 


4-50 


4-52 
4-53 
4-57 
4-58 


4-58 
4-59 











UP-8855 Rev. 1 SPERRY UNIVAC OS/3 Contents 4 
ESCORT 
PART 4. SPECIFICS OF PROGRAM MODE 
5. ESCORT COMMANDS 
5.1. COMMAND SELECTION 5-1 
5.2. TERMS YOU SHOULD KNOW 5-2 
5.3. PROGRAM COMMANDS 5-4 
5.4. HOW TO CHANGE YOUR PROGRAM (CHANGE 
PROGRAM) 5-4 
5.5. HOW TO DISPLAY A PROGRAM ON THE (DISPLAY 
WORKSTATION PROGRAM) 5-5 
5.6. HOW TO DISPLAY A LISTING OF PROGRAM NAMES (DISPLAY 
PROGRAM 
NAMES) 5-5 
5.7, HOW TO ENTER A PROGRAM (ENTER 
PROGRAM) 5-5 
5.8. HOW TO PRINT A PROGRAM (PRINT 
PROGRAM) 5-6 
5.9. HOW TO PRINT A LISTING OF PROGRAM NAMES (PRINT 
PROGRAM 
NAMES) 5-6 
5.10. HOW TO REMOVE A PROGRAM FROM THE SESSION (REMOVE 
FILE PROGRAM FROM 
WORKFILE) 5-6 
5.11. HOW TO REMOVE A PROGRAM FROM THE ESCORT (REMOVE 
LIBRARY PROGRAM FROM 
LIBRARY) 5-7 
5.12. HOW TO EXECUTE YOUR PROGRAM (RUN PROGRAM) 5-7 
5.13. HOW TO SAVE YOUR PROGRAMS (SAVE 
PROGRAM) 5-8 
5.14. STRUCTURE COMMANDS 5-10 
5.15. HOW TO CHANGE A STRUCTURE (CHANGE 
STRUCTURE) 5-10 
5.16. HOW TO DISPLAY A STRUCTURE ON THE (DISPLAY 
WORKSTATION STRUCTURE) 5-11 
5.17. HOW TO DISPLAY A LISTING OF STRUCTURE NAMES (DISPLAY 
STRUCTURE 
NAMES) 5-12 

















UP-8855 Rev. 1 SPERRY UNIVAC OS/3 Contents 5 
ESCORT 





r 5.18. HOW TO BUILD A STRUCTURE (ENTER 
STRUCTURE) 5-12 


5.19. HOW TO INSERT STATEMENTS INTO A STRUCTURE (INSERT INTO 


STRUCTURE) 5-13 
5.20. HOW TO PRINT A STRUCTURE (PRINT 
STRUCTURE) 5-15 


5.21. HOW TO PRINT A LISTING OF STRUCTURE NAMES (PRINT 
STRUCTURE 
NAMES) 5-15 


5.22. HOW TO REMOVE A STRUCTURE FROM THE ESCORT (REMOVE 


LIBRARY OR SESSION FILE STRUCTURE) 5-15 
5.23. HOW TO SAVE A STRUCTURE (SAVE 
STRUCTURE) 5-16 
5.24. JOB COMMANDS 5-17 
5.25. HOW TO CHANGE A JOB (CHANGE JOB) 5-17 
5.26. ‘HOW TO DISPLAY A JOB ON THE WORKSTATION (DISPLAY JOB) 5-18 
_ 5.27. HOW TO DISPLAY A LISTING OF JOB NAMES (DISPLAY 
JOB NAMES) 5-18 
5.28. HOW TO ENTER A JOB (ENTER JOB) 5-18 
5.29. HOW TO PRINT A JOB (PRINT JOB) 5-19 
5.30. HOW TO PRINT A LISTING OF JOB NAMES (PRINT JOB 
NAMES) 5-19 


5.31. HOW TO REMOVE A JOB FROM THE SESSION FILE (REMOVE JOB 


FROM 
WORKFILE) 5-19 
5.32. HOW TO REMOVE A JOB FROM THE ESCORT (REMOVE JOB 
LIBRARY FROM LIBRARY) 5-20 
5.33. HOW TO EXECUTE A JOB (RUN JOB) 5-20 
5.34. HOW TO SAVE A JOB (SAVE JOB) 5-21 
5.35. PASSWORDS COMMANDS 5-21 


5.36. HOW TO DISPLAY THE PASSWORDS OF A FILE ON’ (DISPLAY 


THE WORKSTATION PASSWORDS) 5-22 
& 5.37. HOW TO ENTER OR CHANGE THE PASSWORDS OF A (ENTER OR 
c FILE CHANGE 


PASSWORDS) 5-23 





UP-8855 Rev. 1 


5.38. 


5.39. 


SPERRY UNIVAC OS/3 
ESCORT 


HOW TO REMOVE THE PASSWORDS OF A FILE (REMOVE 
PASSWORDS 
OF FILE) 


HOW TO TERMINATE AN ESCORT SESSION (TERMINATE 
CURRENT 
ESCORT 
SESSION JOB) 


6. ESCORT FILES AND STRUCTURES 


6.1. 


6.2. 


6.3. 


6.4. 


6.5. 


6.6. 


6.7. 


6.13. 


UNDERSTANDING FILES 

TYPES OF FILES 

Indexed Files 

Nonindexed Files 

ALLOCATING FILE SPACE 

HOW TO BUILD A FILE STRUCTURE 

STRUCTURE STATEMENT MAKEUP 

REQUIRED PARTS OF A STRUCTURE STATEMENT 
FIELDNAME 

LENGTH/TYPE 

OPTIONAL PARTS OF A STRUCTURE STATEMENT 
KEYS 

EDIT CODES 

REPEAT COUNT 

START POSITION 

VARIABLE NAME QUALIFIERS QUALIFY FIELD NAMES 
SYSTEM UTILITY FIELDS 

HOW TO ENTER A STRUCTURE 

HOW TO CHANGE A STRUCTURE 

USING COMMANDS TO MANIPULATE YOUR STRUCTURE 


THE STRUCTURE HELP FACILITY 


7. PROGRAMS AND PROGRAM STATEMENTS 


7.1. 


7.2. 


7.3. 


WHAT ARE PROGRAM STATEMENTS? 
PROGRAM STATEMENT FORMAT CONVENTIONS 


ENTER DATA PROGRAM STATEMENT (ENTER DATA) 


Contents 6 


5-23 














UP-8855 Rev. 1 SPERRY UNIVAC OS/3 Contents 7 


ESCORT 
& 7.4. | COMPLETE FORMAT OF THE ENTER DATA PROGRAM 

STATEMENT : 7-5 
7.5. BASIC ENTER DATA PROGRAM STATEMENT 7-6 
7.6. | CHANGE DATA PROGRAM STATEMENT (CHANGE DATA) 7-8 
7.7. COMPLETE FORMAT OF THE CHANGE DATA PROGRAM 

STATEMENT 7-9 
7.8. BASIC CHANGE DATA PROGRAM STATEMENT 7-10 =e 
7.9. SELECT DATA PROGRAM STATEMENT (SELECT DATA) 7-12 


7.10. COMPLETE FORMAT OF THE SELECT DATA PROGRAM 


STATEMENT 7-13 
7.11. BASIC SELECT DATA PROGRAM STATEMENT 7-14 
7.12. SORT DATA PROGRAM STATEMENT (SORT DATA) 7-15 
7.13. FORMAT OF THE SORT DATA PROGRAM STATEMENT 7-15 
7.14. DELETE DATA PROGRAM STATEMENT (DELETE DATA) 7-17 
& 7.15. FORMAT OF THE DELETE DATA PROGRAM STATEMENT 7-17 
7.16. CLAUSES USED WITH PROGRAM STATEMENTS 7-19 
7.17. HOW TO DESIGNATE SORT FIELDS (BY CLAUSE) 7-20 
7.18. HOW TO CLEAR DATA FIELDS (CLEARING 
CLAUSE) 7-21 


7.19. HOW TO CALCULATE EXPRESSIONS AND STORE THE (COMPUTING 


RESULTS CLAUSE) 7-22 
7.20. HOW TO CREATE A NEW DATA FILE (CREATING 
CLAUSE) 7-23 
7.21. HOW TO DISPLAY DATA ON THE WORKSTATION (DISPLAY 
CLAUSE) 7-25 
7.22. HOW TO ENCLOSE CONDITIONALS (END CLAUSE) 7-26 
7.23. HOW TO SPECIFY EARLY TERMINATION OF A (EXIT CLAUSE) 
PROGRAM 7-27 


7.24. HOW TO ADD RECORDS TO AN EXISTING DATA FILE (EXTENDING 
CLAUSE) 7-28 


& 7.25. HOW TO SPECIFY CONDITIONS FOR PROCESSING (IF CLAUSE) 7-29 


7.26. HOW TO OUTPUT YOUR DATA IN A UNIQUE FORMAT (OUTPUT TO 
CLAUSE) 7-31 


UP-8855 Rev. 7 


7.27. 


7.28. 


7.29. 


7.30. 


7.31. 


7.32. 


7.33. 


7.34. 


8. JOBS 


8.1. 


8.2. 


8.3. 


8.4. 


SPERRY UNIVAC 0S/3 
ESCORT 


HOW TO OUTPUT YOUR DATA TO THE PRINTER, (PRINT CLAUSE) 


USING AUTOMATIC FORMATTING 


HOW TO ACCUMULATE SUBTOTALS FOR YOUR (SUBTOTALING 

FIELDS CLAUSE) 

HOW TO ACCUMULATE A RUNNING TOTAL (TOTALING 
CLAUSE) 

HOW TO UPDATE RECORDS IN A FILE (UPDATING 
CLAUSE) 

HOW TO SPECIFY ADDITIONAL FILES (USING 
CLAUSE) 


HOW TO SPECIFY CONDITIONS FOR PROCESSING (WHILE 
CLAUSE) 


HOW TO ALLOCATE WORKING STORAGE (WORKAREA 
CLAUSE) 


CONDITIONS AND SPECIAL OPERATORS USED WITH 
THE IF AND WHILE CLAUSES 


WHAT IS A JOB? 
HOW TO ENTER A JOB 
HOW TO CHANGE A JOB 


USING COMMANDS TO MANIPULATE A JOB 


9. HOW TO CREATE CUSTOMIZED INPUT/OUTPUT FORMS 


9.1. 


9.2. 


9.3. 


9.4. 


9.5. 


9.6. 


9.7. 


WHAT IS A FORM? 


HOW SCREEN FORMAT SERVICES LETS YOU CREATE 
YOUR FORM 


HOW TO CALL THE SCREEN FORMAT GENERATOR 


HOW TO LINK YOUR ESCORT PROGRAM TO A SCREEN 
FORM 


EXAMPLE OF ESCORT STRUCTURE/FORM LINKUP 
SPECIAL ESCORT CONSIDERATIONS FOR FORMS CREATION 


GUIDELINES FOR PRINTING CUSTOM FORMS WITH ESCORT 





Contents 8 


7-32 


7-33 


7-35 


7-36 


7-38 


8-2 


8-3 


9-2 


9-3 


9-4 




















UP-8855 Rev. 1 SPERRY UNIVAC O0S/3 
ESCORT _ 


APPENDIXES 


A. PROGRAM STATEMENT FORMATS 


A.1. CHANGE DATA PROGRAM STATEMENT 
A.2. DELETE DATA PROGRAM STATEMENT 
A.3. ENTER DATA PROGRAM STATEMENT 

A.4. SELECT DATA PROGRAM STATEMENT 


A.5. SORT DATA PROGRAM STATEMENT 


B. RESERVED WORDS 


C. FUNCTION KEY USE 


D. PROGRAMMING CONSIDERATIONS AND SYSTEM GUIDELINES 
D.1. ARITHMETIC CONVENTIONS 
D.2. KEY MATCHING IN A MULTIKEY ENVIRONMENT 
D.3. USES OF THE $LINE SYSTEM UTILITY FIELD 


D.4. USING A DATA FILE WRITTEN IN ANOTHER LANGUAGE 


D.5. ESCORT DATA FILE SHARING GUIDELINES 
D.6. ESCORT SORTING SEQUENCE 
D.7. ESCORT LIBRARY MODULE TYPES 


E. ERROR MESSAGES 


F. SYSGEN REQUIREMENTS AND SYSTEM CONSIDERATIONS 


F.1. SYSGEN REQUIREMENTS 
F.2. EFFICIENCY RECOMMENDATIONS 
F.3. CODING RESTRICTIONS 


G. CUSTOM FORMATTING USING STRUCTURES 


Contents 9 





UP-8855 Rev. 1 SPERRY UNIVAC 0S/3 Contents 10 





ESCORT 
GLOSSARY 
INDEX 
USER COMMENT SHEET 
FIGURES 
1-1. | Program Development in Program Mode 1-8 
1-2. Program Development in Tutorial Mode 1-12 
4-1. Example of Selecting from Another File 4-41 
G-1. Example of Custom Formatting Using Structures G-2 — 
TABLES 
6-1. Edit Codes 6-13 
6-2. System Utility Fields 6-17 
7-1. | Program Statement and Clause Cross-reference 7-2 





C-1. Function Key Use C-1 











WHERE TO BEGIN 











UP-8855 Rev. 1 SPERRY UNIVAC 0S/3 1-1 
ESCORT 


1.Introduction to ESCORT 


1.1. AN EASY-TO-USE LANGUAGE 


Purpose ESCORT is an easy-to-use programming language that helps you 
solve common business problems. 








No programming It's different from most programming languages because you don’t 

experience needed have to be a programmer to use it. With ESCORT, you can write (or 
let ESCORT create) programs to handle payroll, personnel files, 
inventory, etc. 


ESCORT programs don’t look like typical computer programs; they 
Program appearance look more like sentences. Theyre written in English, and you can 
write and understand them easily. This ESCORT screen display is 
much like the ones you'll see as you use this interactive language: 


COMPLETED ESCORT PROGRAM IS AS FOLLOWS: 


ENTER DATA FROM WS CREATING CUSTACCT AND PRINT 
* DEPRESS XMIT TO COMPILE ABOVE STATEMENT 
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1.2. MODES OF OPERATION 


Intended user 








ESCORT 
HAS TWO OPERATING MODES: 


INTERACTIVE TUTORIAL MODE INTERACTIVE PROGRAM MODE 
For The Beginning User For the More Experienced User 


Helps you learn ESCORT by Lets you create 

asking questions and programs faster and use 
using your answers to build more functions. 

a program. 





Interactive Tutorial Mode 


Interactive tutorial mode, which we'll call tutorial mode, is a 
learning tool for those who don’t know much about programming 
or are just learning ESCORT. 





ANS1 
+ 
ANS2 = PROGRAM 


ESCORT displays a series of questions ESCORT uses your answers to create 
on the workstation screen. @ program. 
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Method of operation 


HELP 


Limitations 


This question-and-answer technique lets you create simple 
programs while you learn how ESCORT works. Respond to the 
questions by: 


Filling in the blanks: 


* PROGRAM NAME SPECIFICATION °°° 
“ ENTER THE NAME OF THE PROGRAM, CONFORMING TO THE FOLLOWING RULES : 
- THE PROGRAM NAME MAY BE 1 TO 8 CHARACTERS LONG. 


~ ONLY LETTERS (A-Z) AND NUMBERS (0-9) ARE VALID. 
-— THE FIRST CHARACTER MUST BE A LETTER (A-2Z). 


EXAMPLES: PAYROLL 
ACCTSREC 
LOOKUP 


* ENTER VALID PROGRAM NAME ... 


OR 





Choosing from a list of options: 


“ RETRIEVE DATA FUNCTION (SELECT) ENABLED ° 
CHOOSE ONE OF THE FOLLOWING OPTIONS TO RETRIEVE 
THE DATA: 

1. SELECT DATA FROM WORKSTATION 

2. SELECT DATA WITH CONDITIONS (‘IF’ CLAUSE) 
3. SELECT ALL DATA 

4. HELP ~ EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 


+ 





To help you when you don’t understand a function, many screen 
displays include a choice called HELP, which provides an 
explanation. 


* ENTER DATA FUNCTION ENABLED ° 


SELECT ONE OF THE FOLLOWING DESTINATION OPTIONS FOR THE 
DATA TO BE ENTERED: 

1. CREATE A DATA FILE. (‘CREATING’ CLAUSE) 

2. ADD DATA TO A FILE. (‘EXTENDING CLAUSE) 
+3. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 








While tutorial mode is effective in introducing you to ESCORT and 
teaching you to create simple programs, it is slow and has few 
capabilities. Once you know the terminology of the language and 
feel comfortable with it, you'll use program mode. 


We'll tell you all about tutorial mode in Section 3. 
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Intended user 


Methods of operation 


Screen menu method 
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Interactive Program Mode 


As you become more familiar with ESCORT, you'll want to use in- 
teractive program mode, which we'll call program mode. It’s faster 
than tutorial mode and provides full ESCORT capability. 


Program mode lets you create programs two ways: 


PROGRAM COMMANDS DELETE DATA OF 


1. ENTER PROGRAM INVREORD FROM 
2. RUN PROGRAM ENVDEL 
3. CHANGE PROGRAM 


SELECT COMMAND 





Through a series of screen menus Through direct entry of program statements 


The screen menu method is similar to tutorial mode but not as 
elementary. First, choose a command from a menu displayed on 
the workstation: 


PROGRAM COMMANDS 


. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

- CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

- DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 
. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 


SELECT COMMAND __ PROGRAM NAME 





Then based on your choice, ESCORT takes you from one screen 
display to the next until you complete your function. 
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Advantages of screen menu This makes “‘writing’’ programs easier because all you do is key in 

method (that is, type in) such things as file and structure names, device 
names, and conditional clauses. In this way, you can create com- 
plex programs without having to memorize statement syntax and 
organization. With this method, you have full ESCORT capability, 
but it’s somewhat slower than the direct entry method. 


Typical screen A typical screen you might see when using the screen menu 
method is: 


CHANGE DATA STATEMENT Y 


CHANGE DATA OF file-m (structure-m) (FROM <file-i (structure-i)> } 
( <WS (structure-i)> } 
( <WS (structure-i,formname) ) 


FROM clause, structure-names AND formname ARE OPTIONAL PARAMETERS 
file-m tS NAME OF DATA FILE BEING CHANGED 

file-i IS NAME OF DATA FILE CONTAINING CHANGE CRITERIA 

1F WORKSTATION USED AS CHANGE CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i PARAMETER 


KEYIN PARAMETERS 


structure-m 


structure-t 


formname = : A 


When you're comfortable enough with ESCORT, you'll want to use 
the direct entry method. 





Direct entry method Select the direct entry method by choosing 6, DIRECT ENTRY OF 
PROGRAM STATEMENT on the PROGRAM STATEMENTS menu: 


PROGRAM STATEMENTS 
. ENTER DATA 
. CHANGE DATA 
- SELECT DATA 
. DELETE DATA 
. SORT DATA 


- DIRECT ENTRY OF PROGRAM STATEMENT - FREE FORMAT —_ 


. HELP - EXPLANATION OF STATEMENT FORMAT CONVENTIONS 


SELECTION 





NOTE: 
How keyins are Throughout this manual, we'll use reverse print to show the keyins 
indicated you make on screens. 
Entering program When you press the XMIT key, a blank screen appears and you key 


statements directly in program statements directly. 
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Advantages of direct 
entry method f 


Example of direct 
entry method 


1.3. CONCEPTS OF 


Basic parts 
of ESCORT 
language 
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The direct entry method is faster than the screen menu method 
only if you're familiar enough with ESCORT not to need guidance 
from menus, because you're responsible for statement syntax and 
organization. 


Using the direct entry method, you might key in a program like this: 


p SELECT DATA OF MYFILE 
WORKAREA (WORKI), LINECNT=1 
SUBTOTALING "'SUBTOTAL’’ ,FIELDA, FIELOB 


IF LINECNT<24 
PRINT FIELOA,FIELOB END 


(F LENECNT=24 

PRINT SUBTOTALS 

COMPUTING LINECNT=0 END 
COMPUTING LINECNT=LINECNT+1 
1F ENDOFILE 

PRINT SUBTOTALS END 





Section 4 gives programming examples using both the screen 
menu method and the direct entry method. 


Now that you have an idea of how ESCORT operates, you're ready 
to learn some of the terms and concepts you'll need to know to use 
it effectively. 


ESCORT 


Before you move into the following sections of the manual, you'll 
need to know a few things about the ESCORT language. First, we'll 
describe the parts that comprise it; then we'll show how these 
parts relate to one another. 


The ESCORT language consists of five parts that work together so 
you can perform all ESCORT functions: 


= = Commands 
= §=©6©Statements 
a Programs 

= Structures 


Jobs 
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Commands defined 


Structure statements 
defined 


Program statements 
defined 


Structure defined 


Program defined 


Job defined 


Let’s look at each of these parts briefly. 


Commands tell ESCORT what operation you want to perform on 
your structures, programs, jobs, and data file passwords. Before 
using any other part of ESCORT, you must use a command: We'll 
expand on commands in 1.4 and Section 5. 


Statements are of two types: structure statements and program 
statements. Structure statements define individual fields within 
your data record. One or more structure statements make up a 
structure. Program statements are combinations of ESCORT words 
that name the operations to be performed on your data files. 
Program statements are often supplemented by clauses, which are 
discussed in Section 7. We'll show how statements are used in 
1.4. 


A structure is a collection of structure statements, which tell 
ESCORT what the records in your data files will look like. The 
structure statements define individual fields in your record, and the 
structure defines the entire record. Every file must have a 
structure. We describe structures in 1.4 and Section 6. 


A program is a collection of program statements and associated 
clauses that describe the operations to be performed on your data 
files. You can reference up to 12 files in any ESCORT program. In 
tutorial mode and screen menu program mode, ESCORT creates 
programs from your responses. In direct entry program mode, you 
write the programs. We'll tell more about programs in 1.4 and 
Section 7. 


A job is a group of related programs that are executed together. For 
example, in a payroll job, one program calculates the hours 
worked, one calculates pay and taxes, and the third updates a 
permanent payroll file. We'll tell more about jobs in Section 8. 


Now you're ready to see how these parts fit together. 


1.4. HOW ESCORT WORKS 


This subsection, which illustrates the concepts presented in 1.3, 
gives you an understanding of what ESCORT does to give you your 
program. 


Program Mode 
Look at the following diagram, Figure 1-1. This gives an idea of the 


choices you make that lead to development of your program in 
program mode. 


~~ 
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CHOOSE PROGRAM MODE 





ENTER A NEW 
STRUCTURE 





MANIPULATE AN 
EXISTING 
STRUCTURE. 


LENGTH/ EDIT REPEAT START 
FIELDNAME copes COUNT POSITION 


SELECTIONS 
2 THROUGH 9 <q 





a. Structure commands 





Figure 1-1. Program Development in Program Mode (Part 1 of 3) 











1-9 
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CHOOSE PROGRAM MODE 


ee 


S 


sae 


ee 





CHOOSE COMMAND TYPE > 





CHOOSE COMMAND 





ee 





NEW PROGRAM 


ENTER A 


MANIPULATE AN 


EXISTING 
PROGRAM. 





Sees 
ee 


ee 
ees 





SELECTIONS 
2 THROUGH 10 





CHOOSE FROM ASSORTED 2 


PROGRAM STATEMENTS 


AND CLAUSES IN 
SCREEN MENU 


USE THE 
DIRECT ENTRY 
METHOD. 





PROGRAM MODE 






ENTER DATA STATEMENT 


ENTER DATA FROM WS (structure-name) 


{structure-name, formname) 


structure-name AND formname ARE OPTIONAL PARAMETERS 


wo 
2 
2 
- 
oO 
Ww 
| 
Wu 
na 


MUST ALSO 


formname USED. 


IF 


INCLUDE structure 


SELECT NEXT CLAUSE FOR ENTER DATA STATEMENT 





OUTPUT FO PRINTER clause 
OUTPUT TO WS clause 


CREATING clause 


10 
li. 
12 


WORKAREA clause 


1 
2 


clause 


lF 
WHILE clause 








a 





Program commands 


b. 


Program Development in Program Mode (Part 2 of 3) 


Figure 1-1. 
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ee 


CHOOSE PROGRAM MODE 





PROGRAM MODE 





ENTER A NEW 
JOB 





MANIPULATE 
AN 
EXISTING 






ENTER JOB PAYROLL 
KEVIN PROGRAM NAMES IN ORDER OF EXECUTION FOR THIS JOB 
PROGRAM-1 
PROGRAM-2 






PROGRAM-3 
PROGRAM-4 
PROGRAM-5§ 
PROGRAM-6 
PROGRAM-7 
PROGRAM-8 


es pees 


SELECTIONS 
2 THROUGH 10 


eee 















ee 





c. Job commands 


Figure 1-1. Program Development in Program Mode (Part 3 of 3) 
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Result of choosing 
structure commands 


Result of choosing 
program commands 


Result of choosing 
job commands 


Result of choosing 
password commands 
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Once you choose program mode, you must choose a command. 


Depending on what command type you choose, you can process 
structures, programs, jobs, or data file passwords. 


When you choose structure commands, you have the choice of 
entering a new structure by using structure statements or 
manipulating an _ existing structure with one of the other 
commands. 


When you choose program commands, you enter a new program or 
manipulate an existing program. If you choose to enter a new 
program, you get the PROGRAM STATEMENTS screen and choose 
the program statement that fits the program you want to write. 
Then the appropriate sequence of program mode screens appears 
to complete your program. 


From this PROGRAM STATEMENTS screen, you can also choose to 
enter program statements directly onto a blank screen. 


When you choose job commands, you can enter a new job or 
manipulate an existing job by using one of the other commands. 


When you choose password commands, you may enter any or all 
of the passwords required for the data files named in the programs 
you plan to execute during this session. You may also manipulate 
passwords previously entered during the session. Password 
processing by ESCORT is session oriented. Nothing relating to 
passwords is retained at the end of the session. 
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Tutorial Mode 


Figure 1-2 shows what happens when you choose tutorial mode. 


CHOOSE TUTORIAL MODE 





PICK TUTORIAL <7 





PICK FROM ASSORTED < 
TUTORIAL CHOICES 


"*'* ESCORT TUTORIAL SESSION *** 


A TUTORIAL SESSION 1S PRIMARILY A QUESTION AND ANSWER 
TYPE OF ENVIRONMENT IN WHICH YOU RESPOND BY SELECTING 
ONE OF SEVERAL AVAILABLE OPTIONS. OCCASIONALLY YOU ARE 
REQUIRED TO PROVIDE BRIEF TEXT ENTRIES. 


BEGIN BY IDENTIFYING THE PRIMARY PROGRAM FUNCTION: 


ENTER DATA FROM WORKSTATION 
CHANGE DATA 

RETRIEVE DATA (SELECT) 

DELETE DATA 

SORT DATA 

HELP - EXPLANATION OF OPTIONS 


ENTER SELECTION NUMBER 





Figure 1-2. Program Development in Tutorial Mode 
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ESCORT 

@ Obviously, the process is much simpler. 
Result of choosing You get the first screen of tutorial mode. From there, you can 
tutorial mode proceed with a session and build a program, terminate tutorial, or 


ask for help, which provides an explanation of tutorial mode. 


HELP 


In both Figures 1-1 and 1-2, you probably noticed a HELP option 

on some of the screens. This is a feature built into ESCORT to help 

you understand the function of the screen from which you've y 
requested help. Here is a sample program mode HELP screen: 


STATEMENT FORMAT CONVENTIONS FOR INTERACTIVE PROGRAM MODE 


Sample HELP | PARENTHESIS ENCLOSE PARAMETERS AND CLAUSES. INFORMATION CONTAINED 
screen Pe] WITHIN THE PARENTHESIS REPRESENTS OPTIONAL ENTRIES, WHICH 
DEPENDING UPON PROGRAMMING REQUIREMENTS, ARE INCLUDED OR OMITTED. 


THE SYMBOLS < > ENCLOSE OPTIONAL VALUES OF A PARAMETER. ONE OF THESE 
OPTIONS MUST BE CHOSEN IF THE PARAMETER IS INCLUDED IN THE STATEMENT 


UPPERCASE WORDS DESIGNATE THE PARTS OF THE ESCORT STATEMENT 


THAT ARE AUTOMATICALLY GENERATEO BY THE SYSTEM OR ESCORT RESERVED 
WORDS WHICH ARE OPTIONAL VALUES OF A PARAMETER. 


LOWERCASE WORDS DESIGNATE FIELDS, SUCH AS FILE AND STRUCTURE NAMES, 
THAT THE USER SUPPLIES IN THE PROGRAM STATEMENT. 


DEPRESS TRANSMIT TO RETURN TO PROGRAM SOURCE LANGUAGE SELECTION 





1.5. STATEMENT FORMAT CONVENTIONS FOR SCREENS 


The conventions for program statement formats on all ESCORT 
screens are: 


Words in capital letters (uppercase) are generated for you by the 


system or are alternate parameter choices that are ESCORT fj 


reserved words. 


Words with lowercase letters and embedded hyphens designate 
Conventions used names (such as file and structure names) that you supply. 


in presenting screens 


Optional parameters and clauses are enclosed by parentheses. 


we] Mc | ag Alternative parameter choices are enclosed by the symbols < >. 
: When you specify the parameter, you must pick one of the choices. 
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usage 
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NOTE: 


These conventions apply only to ESCORT screens. Conventions 


used to present statement formats in this manual are shown in 
7.2. 


Look at the following screen to see how each of these conventions 
is used: 


a LOWERCASE WORDS 
ARE SUPPLIED BY YOU. 







THESE SYMBOLS 
ENCLOSE ALTERNATIVE 
PARAMETER CHOICES. 


<> 


SELECT DATA STATEMEN 
SELECT DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
{ <WS (structure-i)> ) 
( <WS (structure-i.formname)>) 
FROM cifause, structure names AND formmame ARE OPTIONAL PARAMETERS 
file-mJ{tS NAME OF DATA FILE BEING SELACTED 
file-iftS NAME OF DATA FILE CONTAINING\SELECT CRITERIA 
IF WORKSTATION USED AS SELECTION CRITER\A DEVICE, THEN 
KEYIN BS FOR file-i PARAMETER 













KEVIN] PARAMETERS 


structure-m 


structure-i 


formname 





) PARENTHESES ENCLOSE 
f OPTIONAL PARAMETERS. 





A UPPERCASE WORDS ARE 
SYSTEM GENERATED. 
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@ 1.6. WHERE TO GO FROM HERE 


inexperienced user 


Experienced user 


Now that you've read Section 1 and understand what ESCORT is 
and how it works, you're ready to move on. This section and 
Section 2 both try to give you enough information so you can start 
up a session. 


The rest of this manual is grouped according to what you might 
need to know at a given time. 


Section 3 deals with tutorial mode, its operation, and how your 
program is built and executed. It includes program examples for 
many tutorial functions. 


Section 4 deals with both the screen menu and direct entry 
methods of program mode. It includes program examples for many 
screen menu options. 


Sections 5 through 9 describe, in more depth, the ESCORT 
concepts mentioned in the previous sections. 


After reading this section and Section 2, if you’re inexperienced 
with computers, begin with Section 3. Then, when you feel 
comfortable with tutorial mode, move into Section 4 (program 
mode). 


If you’re used to programming, you may want to skip Section 3 and 
move right into learning program mode. 
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2. Logging on the System 
and Calling ESCORT 


2.1. PREREQUISITES 


Purpose of section 


Data access method used 
by ESCORT 


System 80 user 
Series 90 user 


System initialization 


This section tells you how to log on (gain entry into) your system 
and call ESCORT. 


It’s important to note that ESCORT works only under con- 
solidated data management. 


If you're using System 80, you automatically have consolidated data 
management; however, for Series 90 systems, there are two types 
of data management possible. The type of data management was set 
at system generation by your system administrator. For more 
information on data management and system generation, see the 
consolidated data management concepts and facilities manual and 
the system installation manual. For more information on ESCORT 
system generation and hardware requirements, see Appendix D. 


If you haven't initialized your system, do so now. For information 
on this procedure, see the operations handbook. 


<_ 
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ESCORT 
2.2. LOGGING ON THE SYSTEM 
Workstation display, For our purposes, we'll assume your system is active and your 
idle system workstations are sitting idle and displaying this screen, which tells 


you to log on: 













000000 SSSS / 333 
00000000 SSSSSS 44 33333 










00 oo ss ss 44h 33 33 
00 oo $s 4 33 
00 00 $s Ms 33 

00 00 $s 4th 333 
00 00 $s 4 33 
00 0o =6$S SS 44 33 33 
00000000 S$$SSSS$ 4/ 3333333 


000000 SSSS$ / 3333 













SPERRY UNIVAC INTERACTIVE OPERATING SYSTEM 
DEPRESS TRANSMIT FOR LOGON 





When to log on You must log on every time you use the workstation. 


Purpose Logging on tells the system you're a legitimate user, and begins an 
accounting of the time you use. It also provides a bulletin containing 
current information about system operation. For more detail on the 
LOGON command, see the interactive services commands and 
facilities user guide/programmer reference. 
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@ How to log on 


System bulletin contents 


Default system bulletin 
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When you press the XMIT key to log on, screen 2-1 appears: 


SCREEN §& 
2-1 





OS/3 INTERACTIVE SERVICES 


LOGON IDENTIFICATION: USER-ID ee < 
ACCOUNT NUMBER at ie 
PASSWORD ee < 
OPTIONS: EXECUTION PROFILE >... < 
BULLETIN DYES < 
Loc DYES < 


Fill in the blanks with the required data and press the XMIT key. 
The system returns a message accepting your logon (screen 2-2): 


SCREEN 
2-2 





OS/3 INTERACTIVE SERVICES 
LOGON ACCEPTED AT 12:45:39 ON 88/81/28. REV. 7.86 


The system then displays the system bulletin, which gives 
information about your system and the procedure for keying in a 
command. 


The default system bulletin looks like this (screen 2-3): 


» Beis coe 
2-3 


{$27 TODAYS BULLETIN IS: 
- TO TYPE IN COMMANDS, DEPRESS ‘FUNCTION’ AND -- 
- ‘SYSTEM MODE’ KEYS SIMULTANEOUSLY, THEN TYPE -- 
- THE COMMAND AND DEPRESS TRANSMIT. 
- ON UNISCOPES DEPRESS ‘MESSAGE WAITING’ KEY. 
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2.3. HOW TO CALL ESCORT 


Calling ESCORT 





Press and hold down the FUNCTION key. 


2 Press the SYS MODE key. | 
- , Press the XMIT key. 
| Release these keys. 


Starting a session The next screen that appears (screen 2-4) is the first screen of 
ESCORT and looks like this: 


peg SCREEN 





Key in the word ESCORT. 








WELCOME TO AN ESCORT TO COMPUTERS: 
PLEASE SELECT YOUR ENTRY POINT: _ 


1 THE PROGRAM MODE 

2. THE TUTORIAL MODE 

3. HELP: A BRIEF DESCRIPTION OF ESCORT 
4 RECOVER A SESSION FILE BY THE NAME: 


AND CONTINUE TO THE PROGRAM MODE...... 
WHEN READY, PRESS TRANSMIT TO CONTINUE 





Menu choices Now you enter an ESCORT operating mode by making a menu 
choice. When you choose: 


r 1 | 
Entering program You enter program mode at the command selection menu (see 
mode Figure 1-1). Here you choose the command type for the 


operation (program, structure, or job) you want to perform. 
You'll learn more about program mode in Section 4. 


s 2 
Entering tutorial You enter tutorial mode. This mode guides you step by step 
mode through simple data operations and is strictly a learning tool. 


You'll learn all about tutorial mode in Section 3. 
] 3 


HELP A screen that explains the other three choices appears. 
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Session file 
recovery 


Password processing 
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a 4 


You have an opportunity to start where you left off at the end 
of a previous ESCORT session if you saved your session file 
when you terminated that session. A session file contains 
everything you enter or change during a session. Key in the 
name of the session file you want to recover. 


If the file you name is password protected, the following 
message appears at the bottom of the screen: 


ESC117 RECOVERY/SAVE REQUIRES PASSWORD 
ENTER READ OR WRITE PASSWORD 


Enter the read password for the file. 


Terminating an ESCORT session and saving the session file 
are described in 5.39. 


Now that you've learned how to call ESCORT and initiate a 
session, choose number 2 on screen 2-4 to enter tutorial mode. Of 
course, if you're moving right into program mode, pick choice 1 and 
proceed to Section 4 of this manual. 




















CONCEPTS OF TUTORIAL MODE 
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3. Interactive Tutorial Mode 


3.1. WHY USE TUTORIAL MODE? 


Purpose of section 


Purpose of tutorial mode 


Intended user 


Purpose of screens 


Effect of selection 


Mistakeproof 


HELP option 


Explanation of 
menu options 


This section takes you through the major tutorial mode functions 
and shows how they work to build a program. 


Tutorial mode is a question-and-answer method that lets you 
perform simple data operations while learning ESCORT 
programming. It is limited in scope, so use it only while you're 
learning ESCORT or are unfamiliar with computer programming. 


In keeping with its question-and-answer format, tutorial mode 
consists of a series of screens that ask you: 


1. To choose functions by selecting a number from a menu 


2. To key in small pieces of text, such as field names, file names, 
or data 


Your responses to these screen displays determine how your 
ESCORT program is set up. 


You can’t make a mistake in statement syntax since ESCORT 
formats the program statements according to your menu choices. 


To help you further, most screen menus include an option called 
HELP. 


When you choose HELP, you receive one or more screens of 
information about the options presented on that tutorial menu. 
After viewing the contents of the HELP screens, press the XMIT 
key to return to the menu where you requested help. 
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Other tutorial 
mode topics 


Resuming processing 
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In addition, you may select the HELP option at any point in tutorial 
mode by pressing the FUNCTION and F2 keys. This displays a 
menu listing all tutorial mode topics that have HELP screens. Make 
a selection from the menu and view the selected HELP screens. 
Then, the menu reappears and you can request additional HELP 
screens. To resume tutorial processing at the point you left off, 
press the FUNCTION and F2 keys. 


3.2. THINGS YOU NEED TO DO BEFORE ENTERING TUTORIAL MODE 


Handling uncataloged 
files 


Entering ESCORT 


In tutorial mode, there are two steps you must take before you can 
create a data file. This is important because you must perform step 
1 before entering ESCORT. For our purposes, we'll assume your 
system is active and you've logged on. You must: 


Step 1: Make Sure the Files You Need Are Cataloged 


Files are cataloged using OS/3 job control statements. In most 
cases, the data files you use are already allocated and cataloged. 
However, if you‘re in an ESCORT session and try to create a file 
that isn't cataloged, you'll get an error message. To catalog a file, 
press the FUNCTION and SYS MODE keys. This puts you into 
system mode and you can run the job control stream to catalog the 
file. To get back to your ESCORT session, press the FUNCTION 
and WS MODE keys. For more information on cataloging files, see 
6.3. 


Step 2: Enter ESCORT 


You enter ESCORT by keying in the word ESCORT and pressing the 
XMIT key. Then the introductory ESCORT screen appears, and you 
choose the mode you want. If you need a review of this process, 
return to 2.3. 


3.3. ENTERING TUTORIAL MODE 


How to enter tutorial mode TO enter tutorial mode, pick choice 2, The TUTORIAL mode, on the 


Standard operating 
procedure 


introductory ESCORT menu by keying in a 2 and pressing the 
XMIT key. 


NOTE: 


Unless told otherwise, press the XMIT key after every entry to send 
your responses to the system. 
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Tutorial mode: initial 
menu 


Function selection 





The system then displays the first menu of tutorial mode (screen 
3-1): 


Seis & 
3-1 





ESCORT TUTORIAL MODE 


1. TUTORIAL SESSION 
2. TERMINATE TUTORIAL 
3. HELP - EXPLANATION OF TUTORIAL 


* ENTER SELECTION NUMBER ... 


obs 


The plus sign (+) on tutorial mode menus indicates the default 
selection. You need not key in a selection number to get the 
default selection; just press the XMIT key. 


Because you want to start a session, pick 1, TUTORIAL SESSION. 
This displays screen 3-2, which asks what function you want to 
perform: 


ma SCREEN 
3-2 


A TUTORIAL SESSION 1S PRIMARILY A QUESTION AND ANSWER 
TYPE OF ENVIRONMENT IN WHICH YOU RESPOND BY SELECTING 
ONE OF SEVERAL AVAILABLE OPTIONS. OCCASIONALLY YOU ARE 
REQUIRED TO PROVIDE BRIEF TEXT ENTRIES 

BEGIN BY IDENTIFYING THE PRIMARY PROGRAM FUNCTION: 


1. ENTER DATA FROM WORKSTATION 





“** ESCORT TUTORIAL SESSION *°* 


2. CHANGE DATA 
3. RETRIEVE DATA (SELECT) 
4. DELETE DATA 
5. SORT DATA 
+ 6. HELP - EXPLANATION OF OPTIONS 
* ENTER SELECTION NUMBER ... 1 | 


The following subsections describe how these choices work. 


Y 
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3.4. ENTERING DATA 


Purpose 


Options 


Option selected 


Since this is your first session, the first thing you'll want to do is 
enter data, so _ pick selection 1, ENTER DATA FROM 
WORKSTATION, on screen 3-2. The next screen that appears 
(screen 3-3) is the first screen of the data entry function, which 
gives you two options for entering data: 


1. Create a new data file 
2. Extend an existing data file 
Because this is your first session, you'll want to create a data file 


and insert data into it. Once your file is created, you can go back at 
another time and insert more data by using the extending option. 


3.5. CREATING A DATA FILE , 


Prerequisite 


Selection 


As you recall from 3.2, there is one step you must complete before 
you can create a data file: you must catalog your file. 


Assuming you have completed this step, key in choice number 1, 
CREATE A DATA FILE (screen 3-3): 


e143 sens eee 
3-3 
* ENTER DATA FUNCTION ENABLED ° 


CHOOSE ONE OF THE FOLLOWING DESTINATION OPTIONS FOR 
THE DATA TO BE ENTERED: 
1. CREATE A DATA FILE (‘CREATING' CLAUSE) 
2. ADD DATA TO A FILE (‘EXTENDING' CLAUSE) 
+ 3. HELP - EXPLANATION OF OPTIONS 





“ ENTER SELECTION NUMBER ... 1 | 
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Specifying file name 


File is named CUSTACCT 


ESCORT search 


Result of search 


Using alternate 
structures 


Using a new structure 
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ENTER CREATE 
° FILE SPECIFICATION ° 

ENTER THE NAME OF THE FILE, CONFORMING TO THE FOLLOWING RULES: 

~ THE FILENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 

~ BASICALLY, ONLY LETTERS (A-Z), NUMBERS (8-9), AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. 

- JF THE FILENAME iS ENCLOSED IN DOUBLE QUOTES ("), ANY 
CHARACTER EXCEPT A SINGLE QUOTE (') OR A DOUBLE QUOTE 
MAY BE INCLUDED, AND EMBEDDED BLANKS ARE ALLOWED. 
EXAMPLES: PAYROLL 

XYZCO/PAYABLES TAXES 
“UNVENTORY MASTER FILE” 


“ENTER A VALID FILENAME ... [RSPR 


You name your file by following the rules listed on the screen (we 


named our file CUSTACCT). 


At this point, ESCORT searches the session file and the library file 
for a structure with the same name as the first eight characters of 
your file name. Because we have not yet created a structure, 


ESCORT doesn’t find one, and screen 3-5 appears: 


SCREEN 
3-5 


NO STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. INDICATE 
HOW YOU WISH TO PROCEED: 

1. KEY IN A STRUCTURE FOR THIS FILE NOW 

2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 

3. KEY IN AN ALTERNATE STRUCTURE NOW 

4. HELP - EXPLANATION OF OPTIONS 


“ ENTER SELECTION NUMBER ... _ 





“ FILE STRUCTURE SPECIFICATION ° 


+ 


If you choose number 2, another screen appears, asking the name 
of the structure you want to use. When you key in an acceptable 
name, you can continue with your program. 


If you choose number 1 or number 3, a screen appears allowing 
you to enter a structure. It’s the same screen you use to enter a 
structure in program mode. When you complete your structure 
entry, you can continue with your program. 
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Structure definition 


Corresponding 
structure entries 
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reoraX—O 


Because we haven't created a structure, choose number 1 on 
screen 3-5 and key in the structure (which ESCORT calls 
CUSTACCT, the same as your file name) on the following screen: 


STRUCTURE OF CUSTACCT 

















LENGTH/ 
FIELDNAME TYPE 


ACCINO 
CRLIM 
CUSTNAME 


CUSTADOR 
CITY 
STATEABB 





lip 





ACCTNO 
CRLIM 
CUSTNAME 
CUSTADDR 
CITY 
STATEABB 
ZIP 


FIELD NAMES 






EDIT REPEAT START 
KEYS CODES COUNT POSITION 


EXPLANATION OF FIELD NAMES 


Account number 
Credit limit 
Customer name 
Customer address 
City 

State abbreviation 
Zip code 


The N, V, and A designations in the structure tell ESCORT what 
type of data will be contained in that field. For an explanation of 
these and other data type designations, see 6.6. 
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Printing data 


PRINT selected 


Assigning program name 
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The next screen (screen 3-6) asks if you want the data you enter to 
be printed. 


SCREEN §& 
3-6 





00 YOU WISH TO PRINT THE DATA THAT YOU ENTER? 


1. YES - PRINT THE DATA (PRINT) 
2. NO - CONTINUE WITH PROGRAM 
3. 


+ HELP - EXPLANATION OF THE ‘PRINT’ CLAUSE 


* ENTER SELECTION NUMBER ... 1 | 


This is your option, but for our purposes, we'll choose to print our 
data by selecting 1, YES - PRINT THE DATA (PRINT). 


This option prints every record you enter on the printer. This is 
helpful to get a report of what you entered so you can check for 
accuracy or just keep track of what’s been entered and what 
hasn't. 


If you want to name your program, designate this on screen 3-7. 


SCREEN 
3-7 







THE PROGRAM YOU HAVE GENERATED WILL BE THE 
RESIDENT PROGRAM CALLED ‘RESIDENT’. FOR FUTURE 
REFERENCE AND PROGRAM MODE MAINTENANCE, YOU MAY 
WISH TO IDENTIFY YOUR PROGRAM WITH A SPECIFIC 
NAME. 


CHOOSE ONE OF THE FOLLOWING OPTIONS: 


1. YES - NAME THE PROGRAM 
2. WO - CONTINUE TUTORIAL SESSION 
+ 3. HELP - EXPLANATION OF NAMING A PROGRAM 


“ENTER SELECTION NUMBER ... [J 


The next screen (screen 3-8) asks you to name your program: 


SCREEN FE 2. 
3-8 
“** PROGRAM NAME SPECIFICATION °** 


° ENTER THE NAME OF THE PROGRAM 
CONFORMING TO THE FOLLOWING RULES * 


THE PROGRAM NAME MAY BE 1 TO 8 CHARACTERS LONG. 
ONLY LETTERS (A-Z) AND NUMBERS (6-9) ARE VALID. 
- THE FIRST CHARACTER MUST BE A LETTER. 
EXAMPLES: PAYROLL 

ACCTSREC 

LOOKUP 


* ENTER VALID PROGRAM NAME ... DRlERS Dey 
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ENTERING 
DATA 





Enter program name 


ESCORT program listing 


Compilation process 


Summary of functions 
completed 


Program disposition 


Key in your program name (we named it CUSTMAST), conforming 
to the rules on the screen. 


Then screen 3-9 appears, listing your ESCORT program: 






SCREEN F 
a) 


ENTER DATA FROM WS 
CREATING CUSTACCT 
AND PRINT 





COMPLETED ESCORT PROGRAM IS AS FOLLOWS: 


* DEPRESS XMIT TO COMPILE ABOVE PROGRAM... _ 


Press the XMIT key to compile your program. Compile means to 
check the syntax and statement order so the program can execute. 


At this point, let’s review what you've done. From the point where 
you entered the tutorial session, you: 


1. 


Z. 


3. 


4. 


5. 


Chose to enter your data from the workstation 
Chose to create a new data file 

Named your file (CUSTACCT) 

Chose to print the data you enter 


Named your program (CUSTMAST) 


The next step is to decide what you want to do with this program. 
Do you want to save it? Do you want to execute it? You decide this 
on the following ‘‘decision’’ screen (screen 3-10): 





me SCREEN § 
3-10 





* ESCORT PROGRAM COMPLETED * 
WHAT WOULD YOU LIKE TO DO NEXT? 
SELECT ONE OF THE FOLLOWING OPTIONS: 


1. SAVE THE PROGRAM 

EXECUTE THE PROGRAM 

. CREATE ANOTHER PROGRAM IN TUTORIAL MODE 

. TERMINATE TUTORIAL AND RETURN TO COMMAND MODE 
- HELP ~ EXPLANATION OF OPTIONS 


ENTER SELECTION NUMBER ... _ 


nm wes 
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Saving the program 


Executing the program 


Creating another 
program 


Terminating tutorial mode 


Options after terminating 
tutorial mode 


Entering data 
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Here are your options: 


Selection number 1, SAVE THE PROGRAM, places your 
program permanently on the ESCORT library file so you can 
execute or change it in a later session. 


Selection number 2, EXECUTE THE PROGRAM, immediately 
executes your program. 


Selection number 3, CREATE ANOTHER PROGRAM IN 
TUTORIAL MODE, allows you to start tutorial mode again and 
create another program. Before you make this selection, be 
sure you saved the program just created if you plan to reuse it 
in another session. If you plan to reuse it in the same session, 


- all you have to do is name it (screens 3-7 and 3-8). If you 


don't save it, ESCORT overwrites the program in the session 
file when you create another program. 


Selection number 4, TERMINATE TUTORIAL AND RETURN TO 
COMMAND MODE, terminates tutorial mode and takes you to 
the command selection menu, which gives you three options: 


1. Enter program mode by selecting one of the command 
types (structure, program, or job) 


2. Enter tutorial mode 
3. Terminate your session 


For this example, you want to execute your program, so 
choose number 2, EXECUTE PROGRAM, on screen 3-10. If 
you followed the example, the program you _ created 
(CUSTMAST) produces the following screen template (which 
parallels your structure) so you can enter data into your file: 


ACCTNO 


CUSTNAME 
CUSTADOR 


STATEABB __ 
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Sending data to 
the system 


Example of data 
entry 


Entering additional 
data 


Moving from field 
to field 


Terminating data entry 
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Fill in each field with data and when you complete the last field, 
press the XMIT key. 


This screen shows some random data we keyed in. 


ACCTNO BREEELY, 


CUSTNAME [DLS A Ce re 


CUSTADDR SEPA LaS [il Rae Or) 
CITY DEMS aay 

STATEABB Ba) 

ZIP BERET 





The data you keyed in is stored as a record, and the screen 
template reappears so you can key in another data record. This 
example uses five records. (For purposes of brevity, assume we've 
entered random data into our fields. If you want, you can enter 
your own data.) 


When you key data into a field and it takes up the entire amount of 
space allotted for that field (e.g., a 7-digit account number into a 
7N field), the cursor automatically moves to the next field. If, 
however, you key in data that doesn’t fill the space allotted (e.g., a 
15-character name in a 20A field), you must move the cursor to 
the next field by pressing the TAB FORWARD key. 


When you enter all the records you want in your file, press the 
FUNCTION and F4 keys to signify the end of input to the system. 


At this point, because you chose to print your data (screen 3-6), 
ESCORT prints every data record you entered (five). 
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Example of data 
printout 


O 
O 
O 
oO 
oO 
2) 
oO 
O 
O 
oO 
O 
O 
oO 
oO 
O 
O 
oO 
O 
O 
O 
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ENTERING 
DATA 





Based on the data we entered, the printer output for this example 
looks like this: 


DATE 81/11/18 TIME 10:04:21 --SYSTEM 80 - ESCORT DATA LISTING-- PAGE 001 


ACCTNO: 1234567 
CITY: HATFIELD 


ACCTNO: 2345678 
CITY: BIRDSBORO 


ACCTNO: 3456789 
CITY: PROMPTLY 


ACCTNO: 2999478 
CITY: PAMPERED 


ACCTNO: 7483219 
CITY: BASTILLE 


CRLIM: 1999.90 CUSTNAME: DAVID J. PARALOVER CUSTADDR: 1879 BREMONT ROAD 
STATEABB: PA ZIP: 19449 


CRLIM: 2909.99 CUSTNAME: GREENE E. BYRD 
STATEABB: PA ZIP: 19444 


CRLIM: 5990.00 CUSTNAME: IMA GOODRISK 
STATEABB: NY ZIP: 99876 


CRLIM: 19,000 CUSTNAME: EYAM A. RICHMAN 
STATEABB: NY ZIP: 72782 


CRLIM: 700.09 CUSTNAME: LYKTA SPENDMONEY 
STATEABB: DE ZIP: 14832 





Then the decision screen (screen 3-10) reappears, and you decide 
where to go from here. 
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CHANGING 
© DATA 
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3.6. CHANGING DATA 


Methods of change 


Entering tutorial mode 


Selecting a method 


Using the data file created in 3.5, change it by using one of three 
methods available to you: 


1. Selecting the records to be changed and changing them from 
the workstation 


2. Changing records based on conditions 

3. Changing all records 

You enter tutorial mode by the method outlined in 3.3. When you 
get to the function screen (screen 3-2), choose number 2, CHANGE 
DATA. 

The next screen that appears is the CHANGE DATA menu (screen 


3-11); it offers you three options and a HELP facility, which 
explains these options: 


my SCREEN FO 
3-11 





* CHANGE DATA FUNCTION ENABLED ° 


SELECT ONE OF THE FOLLOWING OPERATIONS TO 
CHANGE THE DATA: 


1. CHANGE DATA BY SELECTING FROM WORKSTATION 
2. CHANGE DATA WITH CONDITIONS (‘IF°’ CLAUSE) 
3. CHANGE ALL DATA 

4. HELP - EXPLANATION OF OPTIONS 


ENTER SELECTION NUMBER ... _ 


+ 





3.7. CHANGING DATA FROM THE WORKSTATION 


Method for unkeyed files 


Method for keyed files 


When you change data by selecting from the workstation, each 
record (if you have an unkeyed file) or the key fields in each record 
(if you have a keyed file) are displayed on the workstation. (See 6.2 
and 6.7 for details on keyed and unkeyed files.) If you have an 
unkeyed file, you simply change the data fields you want to change 
by keying over the data that is displayed. If you have a keyed file, 
the key field prompt is displayed on the workstation, you enter the 
key data for the record you want to change, and that record is then 
displayed on the workstation and you make your changes. 
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Selecting the change 
method 


Name the file to be 
changed 
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CHANGING 
DATA 





To choose CHANGE DATA BY SELECTING FROM WORKSTATION 
on screen 3-11, key in number 1 and press the XMIT key. 


The next screen (screen 3-12) asks you to name the file you want 
to change. Because you're using the same keyed file you created in 
3.5, key in the name CUSTACCT. 


SCREEN 


3-12 





CHANGE MASTER 
* FILE SPECIFICATION ° 
ENTER THE NAME OF THE FILE, CONFORMING TO THE FOLLOWING RULES: 


- THE FILENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 
BASICALLY, ONLY LETTERS (A-Z), NUMBERS (8-9), AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. 


- UF THE FILENAME IS ENCLOSED IN DOUBLE QUOTES (”), ANY 
CHARACTER EXCEPT A SINGLE QUOTE (°) OR A DOUBLE QUOTE 
MAY BE INCLUDED, AND EMBEDOED BLANKS ARE ALLOWED. 


EXAMPLES: PAYROLL 
XYZCO/PAYABLES, TAXES 
“INVENTORY MASTER FILE” 


‘ENTER VALID FILENAME ... BURSEYOG = 


As previously explained (3.5), ESCORT now searches the session 
and library files to find the structure with the same name as the 
first eight characters of your file name. 


Because the structure you created when you entered data is in the 
session file, screen 3-13 appears. Choose selection 1 to use the 
previously created structure. 


SCREEN 
3-13 





* FILE STRUCTURE SPECIFICATION * 


A STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. INDICATE 
HOW YOU WISH TO PROCEED: 

1. USE THE EXISTING STRUCTURE FOR THIS FILE 

2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 

3. KEY IN AN ALTERNATE STRUCTURE NOW 

4. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER:... 1 | 
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Printing changed data The next screen (screen 3-14) asks if you want the changed data 
printed: 


me SCREEN F 
" 3-14 





DO YOU WISH TO PRINT THE DATA THAT 
1S CHANGED? 


1. YES - PRINT THE CHANGED DATA 
2. NO - CONTINUE WITH PROGRAM 
3. 





+ HELP - EXPLANATION OF THE ‘PRINT’ CLAUSE 
* ENTER SELECTION NUMBER ... 1 | 
Printing selected For your purposes, choose number 1, YES ~- PRINT THE CHANGED 


DATA and press the XMIT key. 


If you wanted to name your program, you could designate this on 
screen 3-15: 


SCREEN 
3-15 





THE PROGRAM YOU HAVE GENERATED WILL BE THE 
RESIDENT PROGRAM CALLED ‘RESIDENT’. FOR FUTURE 
REFERENCE AND PROGRAM MODE MAINTENANCE, YOU MAY 
WISH TO IDENTIFY YOUR PROGRAM WITH A SPECIFIC 
NAME. 

CHOOSE ONE OF THE FOLLOWING OPTIONS: 


1. YES - NAME THE PROGRAM 
NO - CONTINUE TUTORIAL SESSION 
HELP - EXPLANATION OF NAMING A PROGRAM 


“ENTER SELECTION NUMBER ... 


Naming programs 


2. 
ee Ie 





Because we don’t want to name our program, ESCORT assumes 
we're using the RESIDENT name. 


Then screen 3-16 appears, listing your ESCORT program: 


SCREEN 
3-16 





COMPLETED ESCORT PROGRAM IS AS FOLLOWS: 


Program listing CHANGE DATA OF 
CUSTACCT 
FROM WS AND PRINT 


* DEPRESS XMIT TO COMPILE ABOVE PROGRAM 
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ESCORT 
a a a ee 
CHANGING 
DATA 
Compiling your program When you press the XMIT key to compile your data change 


program, the following decision screen (3-17) appears: 


SCREEN Jae Tn eee — Y 
3-17 <i 
* ESCORT PROGRAM COMPLETED ° 


WHAT WOULD YOU LIKE TO DO NEXT? 
SELECT ONE OF THE FOLLOWING OPTIONS: 

1. SAVE THE PROGRAM 

2. EXECUTE THE PROGRAM 

3. CREATE ANOTHER PROGRAM IN TUTORIAL MODE 

4. TERMINATE TUTORIAL AND RETURN TO COMMAND MODE 
+5. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 





Executing the program The action initiated by each of these selections is listed under 
screen 3-10. For your purposes, choose number 2, EXECUTE THE 
PROGRAM, to execute your program. 


Sample output Because your file is a keyed file and its key field is ACCTNO, the 
& following prompt is displayed on your workstation screen: 


ACCTNO 





Example Suppose you want to change the record for customer Greene E. 
Byrd. The account number for that customer's record is 2345678. 
You key in that account number, and the rest of the record is 
displayed. Then you can make your changes. 







ACCTINO PREETPE} 


ACCTNO 2345678 
CRLIM 2088.08 
CUSTNAME GREENE £. BYRD 


CUSTADDR 1212 KEET STREET 
CiTY BIRDSBORO 

STATEABB PA 

ZIP 19444 
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CHANGING 
‘ DATA 


After you make your changes for that record and press the XMIT 
key, the prompt reappears so you can change another record. 


Terminating the change When you finish changing your records, press the FUNCTION and 
F4 keys to specify the end of input. <~ 
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3.8. RETRIEVING DATA (SELECT) 


Data selection methods 


Entering tutorial mode 


Data selection options 





Using the same data file as in previous subsections, now select 
(retrieve) data, using one of three available methods: 


1. Select from the workstation 

2. Select based on conditions 

3. Select all data 

Enter tutorial mode, using the method outlined in 3.3. When you 
get to the function screen (screen 3-2), choose number 3, 
RETRIEVE DATA (SELECT). 

The next screen that appears is the SELECT DATA menu (screen 


3-18), which offers you three options and a HELP facility 
explaining these options. 


ma SCREEN §& 
3-18 





* RETRIEVE DATA FUNCTION (SELECT) ENABLED ° 


SELECT ONE OF THE FOLLOWING OPTIONS TO RETRIEVE 
THE DATA: 


1. SELECT DATA FROM WORKSTATION 

2. SELECT DATA WITH CONDITIONS (‘IF’ CLAUSE) 
3. SELECT ALL DATA 

4. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 


3.9. SELECTING DATA BASED ON CONDITIONS 


Choosing the select 
function 


Selecting data based on conditions means that you designate one 
or more conditions that must be met before the record is selected. 
Using the data file and structure (CUSTACCT) created in 3.5, this 
SELECT DATA example selects the records from CUSTACCT only if 
the credit limit field (CRLIM) is over 5000 dollars. 


To choose SELECT DATA WITH CONDITIONS, key in number 2 on 
the SELECT DATA menu (screen 3-18) and press the XMIT key. 
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Naming the file 


RETRIEVING 


: DATA 
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The next screen (screen 3-19) asks you to name the file from 
which you want to select records. Because you're using the same 
file you created in 3.5, key in the name CUSTACCT. 

RETREEVE MASTER 


SCREEN — 
3-19 
“FILE SPECIFICATION® 


ENTER THE NAME OF THE FILE. CONFORMING TO THE FOLLOWING RULES: 
~ THE FELENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 


- BASICALLY, ONLY LETTERS (A-Z). NUMBERS (8-9). AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. 

- JF THE FELENAME IS ENCLOSED IN DOUBLE QUOTES ("), AMY 
CHARACTER EXCEPT A SINGLE QUOTE (°) OR A DOUBLE QUOTE 
MAY BE INCLUDED, AND EMBEDDED BLANKS ARE ALLOWED. 
EXAMPLES: PAYROLL 

XYZCO/PAYABLES, TAXES 
“INVENTORY MASTER FILE” 


‘ ENTER VALID FILENAME ... CURSZYTR 





As previously explained (3.5), ESCORT now searches the session 
and library files to find the structure with the same name as the 
first eight characters of your file name. 


Because a structure for your file exists, screen 3-20 appears. 
Again, choose selection 1 and use the previously created structure. 


SCREEN & 
3-20 
“ FILE STRUCTURE SPECIFICATION * 


A STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. INDICATE 
HOW YOU WISH TO PROCEED: 

1. USE THE EXISTING STRUCTURE FOR THIS FILE 

2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 

3. KEY IN AN ALTERNATE STRUCTURE NOW 

4. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... 1] 





+ 

















UP-8855 Rev. 1 SPERRY UNIVAC O0S/3 3-19 
ESCORT 


ne 


RETRIEVING 
DATA 





At this point, ESCORT knows what file you want to access, and the 
next screen (screen 3-21) asks you to specify the conditions for 
selecting data from that file. 


SCREEN 
3-21 





* CONDITIONAL SELECTION ENABLED ° 
Condition specification 1. ENTER A CONDITIONAL STATEMENT 
+ 2. HELP - EXPLANATION OF CONDITION CLAUSES 
ENTER SELECTION NUMBER ...f§ 


Example Key in number 1. Screen 3-22 appears, and you key in your 
conditional statement. The record selection for this example 
depends on whether the value of the credit limit field (CRLIM) is 
more than 5000 dollars. 


SCREEN Y 
3-22 





PROVIDE AN ‘JF’ CONDITION CLAUSE. THE CLAUSE 
MUST INCLUDE A FIELD NAME FROM THE STRUCTURE, 
A RELATIONAL OPERATOR OR STRING OPERATOR, AND 
AN EXPRESSION. 






EXAMPLE: 


<FLELD-NAME> <OPERATOR> <EXPRESSION/CHARACTER STRING> 
1F BALANCE EQ 268 + CREDIT 


“ ENTER REQUIRED VARIABLES ... 
<FIELO-NAME> <OPERATOR> <EXPRESSION/CHARACTER STRING> 


1 GM) =. 20) -----) --- ee 
Additional options The next screen (screen 3-23) asks what you want to do next. You 


have three options and a HELP choice: 


SCREEN 
3-23 





YOU MAY ENTER MORE CONDITIONS - 
INDICATE HOW YOU WISH TO PROCEED: 


1. ENTER AN ‘AND’ CONDITION CLAUSE. 

2. ENTER AN ‘OR’ CONDITION CLAUSE. 

3. CONTINUE WITH PROGRAM (ALL CONDITIONS SPECIFIED). 
+ 4 


* ENTER SELECTION NUMBER .. 








. HELP - EXPLANATION OF ENTERING MORE CONDITIONS. << 
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RETRIEVING 
« DATA 


Maximum number of 
conditions 


Calculation option 


Option denied, continue 


Output file option 


Output to another file 
decision 
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Because the example program only specifies one condition for 
selection of records, choose number 3, CONTINUE WITH 
PROGRAM. 

NOTE: 


When you choose to enter conditions, you may enter up to four 
conditions in tutorial mode. 


The next screen (screen 3-24) asks if you want to perform any 
calculations with your data: 


SCREEN 
3-24 





00 YOU WISH TO PERFORM ANY CALCULATIONS 
ON YOUR RETRIEVED DATA 
1. YES ~ ENTER A ‘COMPUTING’ CLAUSE. 
2. NO - CONTINUE WITH PROGRAM. 
+ 3. HELP - EXPLANATION OF ‘COMPUTING’ CLAUSE. 


* ENTER SELECTION NUMBER .. og 


Because you don’t want to perform any calculations, choose 
number 2, NO - CONTINUE WITH PROGRAM. 


The next screen (screen 3-25) asks if you want to output your data 
to another file: 


SCREEN 
3-25 





DO YOU WISH TO OUTPUT YOUR RETRIEVED 
DATA TO ANOTHER FILE? 





1. YES - OUTPUT THE DATA TO ANOTHER FILE 
2. NO - CONTINUE WITH PROGRAM : 
+ 3. HELP - EXPLANATION OF OUTPUT FILE OPTIONS. 


“ ENTER SELECTION NUMBER .. QJ 


Assume you want to output the records of all customers with a 
credit limit greater than 5000 dollars into a separate file for special 
credit mailings, so choose number 1, YES - OUTPUT THE DATA TO 
ANOTHER FILE. 
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Type of file for output 


Creating new output file 


Name new output file 
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Then you must specify, on the next screen (screen 3-26), whether 
you are creating a completely new file with this data or extending 
an existing one. 


SCREEN §&-: 
3-26 





SELECT ONE OF THE FOLLOWING OPTIONS TO 
OUTPUT THE RETRIEVED DATA TO ANOTHER FILE 


+ 1. CREATE A DATA FILE (CREATING) 
2. ADD TO A DATA FILE (EXTENDING) 


* ENTER SELECTION NUMBER an | | 


For this example, assume you're using a completely new file, so 
choose number 1, CREATE A DATA FILE (CREATING). 


Then on screen 3-27, you must name the file you're creating. We'll 
name it CREDMAIL: 
RETRIEVE CREATE 


SCREEN FF 
3-27 
* PILE SPECIFICATION ° 


ENTER THE NAME OF THE FILE, CONFORMING TO THE FOLLOWING RULES: 
- THE FILENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 


- BASICALLY, ONLY LETTERS (A-Z), NUMBERS (8-9), AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. 

- IF THE FILENAME |S ENCLOSED IN DOUBLE QUOTES ("), ANY 
CHARACTER EXCEPT A SINGLE QUOTE (') OR A DOUBLE QUOTE 
MAY BE INCLUDED, AND EMBEDDED BLANKS ARE ALLOWED. 
EXAMPLES: PAYROLL 

XYZCO/PAYABLES. TAXES 
“INVENTORY MASTER FILE” 


* ENTER VALID FILENAME ... [aay 6 6 tae i Souths Bet tous 





As previously explained (3.5), ESCORT now searches the session 
and library files to find the structure with the same name as the 
first eight characters of your file name. 


You have not created a structure for this file, so the following 
screen (screen 3-28) appears 
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Disposition of selected 


' 


Since the layout of the records in the CUSTACCT file is the same 
as this file, you may use the same structure. Choose selection 2. 


SCREEN 
3-28 


NO STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. INDICATE 
HOW YOU WISH TO PROCEED: 

1. KEY IN A STRUCTURE FOR THIS FILE NOW 

2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 

3. KEY IN AN ALTERNATE STRUCTURE NOW 

4. HELP - EXPLANATION OF OPTIONS 


ENTER SELECTION NUMBER .. .£R 





* FILE STRUCTURE SPECIFICATION ° 


ao 


The following screen (screen 3-29) appears. Enter the alternate 
structure name CUSTACCT. 





* ALTERNATE STRUCTURE SPECIFICATION ° 


ENTER THE NAME OF THE ALTERNATE STRUCTURE 
YOU WISH TO USE WITH THE CURRENT FILE. 


* ENTER VALID STRUCTURE NAME ... [Upset 


t 


The next screen (screen 3-30) asks if you want to see the data you 
select: 


SCREEN J 
3-30 





DO YOU WISH TO DISPLAY OR PRINT YOUR 
RETRIEVED DATA? 


1. YES - DISPLAY OR PRINT THE DATA 
2. NO - CONTINUE WITH PROGRAM 


“ ENTER SELECTION NUMBER .. 








+ 3. HELP - EXPLANATION OF ‘DISPLAY’ AND ‘PRINT’ CLAUSES <—— 
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Because you want to examine the data you select, choose 1, 
DISPLAY OR PRINT THE DATA. The next screen (screen 3-31), 
asks how you want to examine your data: 


SCREEN FF 
3-31 





SPECIFY ONE OF THE FOLLOWING OPTIONS TO 
EXAMINE YOUR DATA 


1. DISPLAY THE DATA TO THE WORKSTATION (DISPLAY) 
Viewing the data + 2. PRINT THE DATA (PRINT) 


* ENTER SELECTION NUMBER .. .—¥ 


Choosing the PRINT option Assume that you want a listing of all credit customers with a credit 
limit over 5000 dollars, so choose number 2, PRINT THE DATA. 


If you want to name your program, you designate this on screen 
3-32. 


SCREEN 
3-32 





THE PROGRAM YOU HAVE GENERATED WILL BE THE 
RESIDENT PROGRAM CALLED ‘RESIDENT’. FOR FUTURE 
REFERENCE AND PROGRAM MODE MAINTENANCE, YOU MAY 
WISH TO IDENTIFY YOUR PROGRAM WITH A SPECIFIC 
NAME. 


Naming your program CHOOSE ONE OF THE FOLLOWING OPTIONS: 


1. YES - NAME THE PROGRAM 
2. NO - CONTINUE TUTORIAL SESSION 
+ 3. HELP - EXPLANATION OF NAMING A PROGRAM <_ 


* ENTER SELECTION NUMBER ...Q 


Then screen 3-33 appears, and you can name your program. For 
this example, we'll name our program CREDMLST: 


« Sean 
eK} 





* PROGRAM NAME SPECIFICATION °** 
* ENTER THE NAME OF THE PROGRAM 


Assign program name CONFORMING TO THE FOLLOWING RULES * 


~ THE PROGRAM NAME MAY BE 1 TO 8 CHARACTERS LONG. 
- ONLY LETTERS (A-Z) AND NUMBERS (8-9) ARE VALID. 
- THE FIRST CHARACTER MUST BE A LETTER (A-Z). 
EXAMPLES: PAYROLL 
ACCTSREC 
LOOKUP 
* ENTER VALID PROGRAM NAME .. .[opaSo] Tiay 
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SPERRY UNIVAC 0S/3 3-24 


ESCORT 
no 


The next screen (screen 3-34) lists your ESCORT program: 


SCREEN 
3-34 






COMPLETED ESCORT PROGRAM IS AS FOLLOWS: 
SELECT DATA OF 

CUSTACCT 

IF CRLIM GT 5868 

CREATING CREDMAIL (CUSTACCT) 

AND PRINT 

END 





“ DEPRESS XMIT TO COMPILE ABOVE PROGRAM 


Now your program is completed, and you must decide what to do 
next on the following decision screen (screen 3-35): 


Se ea S 
3-35 
* ESCORT PROGRAM COMPLETED * 


WHAT WOULD YOU LIKE TO DO NEXT? 
SELECT ONE OF THE FOLLOWING OPTIONS: 


1. SAVE THE PROGRAM 

2. EXECUTE THE PROGRAM 

3. CREATE ANOTHER PROGRAM IN TUTORIAL MODE 

4. TERMINATE TUTORIAL AND RETURN TO COMMAND MODE 
5. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 





The action initiated by each of these choices is listed under screen 
3-10. For your purposes, choose number 2, EXECUTE THE 
PROGRAM, to execute your program. 


Because there is only one record in the file CUSTACCT with a 
credit limit over 5000 dollars, this record is both printed and 
written to the file CREDMAIL: 


DATE 81/11/18 TIME 10:04:21 ~~SYSTEM 80 - ESCORT DATA LISTING-- PAGE 001 


ACCTNO: 2099478 


oO CITY: PAMPERED 


CRLIM: 1999.99 CUSTNAME: EYAM A. RICHMAN CUSTADDR: 7483 LUXURY LANE 
STATEABB: NY ZIP: 72782 
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3.10. SORTING DATA 
The SORT DATA statement lets you take an unindexed, unordered 
Purpose of SORT DATA file and sort it, creating a new sorted file. (We'll explain file types 
and organization in 6.2.) 


The SORT DATA statement gives you two ways to sort a file: 


SORT DATA options 1. By using a field name that has been designated as a key in 
the output CREATING file 


2. By specifying field names from the master file structure 


Enter tutorial mode You enter tutorial mode in the method outlined in 3.3. When you 
get to the function screen (screen 3-2), you choose number 5, 
SORT DATA. 


The next screen that appears (screen 3-36) is the SORT DATA 
screen, which offers you two options and a HELP facility that 
& explains these options: 


mae SCREEN §& 
3 36 





* SORT DATA FUNCTION ENABLED * 


SELECT ONE OF THE FOLLOWING OPTIONS TO SORT 
YOUR DATA: 


Option selection 


1. SORT DATA BY MATCHING DATA DESCRIPTION FIELD IN STRUCTURE 
2. SORT DATA BY FIELD NAMES. 
+ 3. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 
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3.11. SORTING DATA BY FIELD NAMES 


Structure of CUSTSORT 


Example 


Choose an option 


Name the file 


For this. example, use the data file CUSTACCT created in 3.5, and 
create a new structure CUSTSORT to use with this program 
statement. CUSTSORT has the same fields as the structure 
CUSTACCT, but eliminates the sort field designation for ACCTNO. 
You do this because the key designation makes CUSTACCT an 
indexed file using the ACCTNO field. Eliminating this key 
designation lets you reference CUSTACCT as a sequential file. The 
SORT DATA statement is used primarily to create sequential files. 
The new structure named CUSTSORT appears: 


STRUCTURE OF CUSTSORT 


| ACCTNO 
CRLIM 
CUSTNAME 
CUSTADDR 


CITY 
STATEABB 
ZIP 





For this example, assume you want to sort the file CUSTACCT 
(created in 3.5) in alphabetical order by the state where the 
customer lives (STATEABB) and the account number (ACCTNO). 


To choose SORT DATA BY FIELD NAMES, key in number 2 on the 
SORT DATA screen (screen 3-36) and press the XMIT key. 


The next screen (screen 3-37) asks you the name of the file you 
want to sort. Because you're using the same file you created in 
3.5, key in the name CUSTACCT: 

SORT MASTER 


won BLOGS eee 
; 3-37 
* FILE SPECIFICATION ° 


ENTER THE NAME OF THE FILE, CONFORMING TO THE FOLLOWING RULES: 

- THE FILENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 

~ BASICALLY, ONLY LETTERS (A-Z), NUMBERS (8-9), AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. 

- HF THE FILENAME tS ENCLOSED IN DOUBLE QUOTES (”), ANY 
CHARACTER EXCEPT A SENGLE QUOTE (’) OR A DOUBLE QUOTE 
MAY 8E INCLUDED. AND EMBEDDED BLANKS ARE ALLOWED. 
EXAMPLES: PAYROLL 

XYZCO/PAYABLES. TAXES 
“INVENTORY MASTER FILE” 


‘ ENTER A VALIO FILENAME ... GUBRRYRee 0 0 
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As previously explained (3.5), ESCORT now searches the session 
and library files to find the structure with the same name as the 
first eight characters of your file name. 


Choose selection 3 on the following screen (screen 3-38) to key in 
the alternate structure CUSTSORT for the CUSTACCT file. 


Sea a 
3-38 
* FELE STRUCTURE SPECIFICATION * 


A STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. INDICATE 
HOW YOU WISH TO PROCEED: 

1. USE THE EXISTING STRUCTURE FOR THIS FILE 

2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 

3. KEY IN AN ALTERNATE STRUCTURE NOW 
+ 4. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... Ey 





The next screen (screen 3-39) asks you to specify the field names 
by which you want to sort your data. 


2 SCREEN §—........ BOC yee EOS OSS 
3-39 *** SORT DATA FIELD NAME SPECIFICATION °*°* 


ENTER THE FIELD NAMES THAT YOU WISH 
TO USE FO ORGANIZE YOUR DATA. 





YOU MAY ENTER 1 TO 6 FIELD NAMES. 


AFTER AT LEAST ONE FIELD NAME HAS 
BEEN ENTERED, YOU MAY INDICATE THAT 
NO MORE FIELD NAMES ARE TO BE 
ENTERED BY SIMPLY DEPRESSING XMIT 
WITHOUT ENTERING A FIELD NAME. 


* ENFER A VALID FIELD NAME ... 





Because you want to sort your data alphabetically by state and 
numerically by account number, key in the field name STATEABB 
and press the XMIT key. The screen then reappears and you key in 
ACCTNO and press the XMIT key. The screen reappears again. 
Because you have no more sort fields to designate, just press the 
XMIT key to continue with your program. 
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Name the output file The next screen (Screen 3-40) asks you to designate the name of 


the output file that is to contain the results of your sort: 





ENTER THE NAME OF THE FILE, 


Mm SCREEN BE. 8 
3-40 





* SORT CREATE 
* FILE SPECIFICATION ° 


THE FILENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 


BASICALLY, ONLY LETTERS (A-Z), NUMBERS (8-9), AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. 
IF THE FILENAME 1S ENCLOSED IN DOUBLE QUOTES ("), ANY 
CHARACTER EXCEPT A SINGLE QUOTE (') OR A DOUBLE QUOTE 
MAY BE INCLUDED, AND EMBEDDED BLANKS ARE ALLOWED. 
EXAMPLES: PAYROLL 

XYZCO/PAYABLES, TAXES 

“INVENTORY MASTER FILE” 


ENTER VALID FILENAME ... RREMMSMM 


CONFORMING TO THE FOLLOWING RULES: 


Output file named For this example, the new sorted file name is STATEFIL. 


STATEFIL 


As previously explained (3.5), ESCORT now searches the session 
and library files to find the structure with the same name as the 
first eight characters of the output file name you designated. 


There is no structure for the file STATEFIL, but you may use the 
CUSTSORT structure because the layouts of the records in the files 
are the same. Choose selection 2 on the following screen (screen 


3-41). 


SCREEN §& 
3-41 


NO STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. 


* FILE STRUCTURE SPECIFICATION ° 


HOW YOU WISH TO PROCEED: 
1. KEY #N A STRUCTURE FOR THIS FILE NOW 


2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 


3. KEY IN AN ALTERNATE STRUCTURE NOW 
+ 4. HELP - EXPLANATION OF OPTIONS 
* ENTER SELECTION NUMBER ... E 





INDICATE 
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The following screen (screen 3-42) appears. Enter the alternate 
structure name CUSTSORT. 


SCREEN —.. 
3-42 





*" ALTERNATE STRUCTURE SPECIFICATION * 


ENTER THE NAME OF THE ALTERNATE STRUCTURE 
YOU WISH TO USE WITH THE CURRENT FILE. 


* ENTER VALIO STRUCTURE NAME ... DRURRRSCOS 


The next screen (screen 3-43) gives you the option to name the 
program you have completed or continue with it: 


SCREEN §& 
3-43 





THE PROGRAM YOU HAVE GENERATED WILL BE THE 
RESIDENT PROGRAM CALLED ‘RESIDENT’. FOR FUTURE 
REFERENCE AND PROGRAM MODE MAINTENANCE, YOU MAY 

Naming your program WISH TO [DENTIFY YOUR PROGRAM WITH A SPECIFIC 
NAME. 


CHOOSE ONE OF THE FOLLOWING OPTIONS: 

1. YES - NAME THE PROGRAM 

2. NO - CONTINUE TUTORIAL SESSION 

3. HELP - EXPLANATION OF NAMING A PROGRAM 
* ENTER SELECTION NUMBER .. 8 


ae 


Because you probably will not want to save or reuse this program, 
Program name option choose 2, NO - CONTINUE TUTORIAL SESSION. This is the final 
denied tutorial screen for the SORT DATA program statement. 


Your completed ESCORT program appears (screen 3-44): 


SCREEN 
3-44 





COMPLETED ESCORT PROGRAM IS AS FOLLOWS: 


SORT DATA OF 

CUSTACCT 

BY STATEABB ACCTNO 

CREATING STATEFIL (CUSTACCT) 


* DEPRESS XMIT KEY TO COMPILE ABOVE STATEMENT ... 


Program listing 











Y 


t 
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When you press the XMIT key to compile your SORT DATA 
program, the following decision screen appears (screen 3-45): 


"mg SCREEN 
3-45 





* ESCORT PROGRAM COMPLETED * 
WHAT WOULD YOU LIKE TO DO NEXT? 
SELECT ONE OF THE FOLLOWING OPTIONS: 


1. SAVE THE PROGRAM 

EXECUTE THE PROGRAM 

CREATE ANOTHER PROGRAM IN TUTORIAL MODE 
TERMINATE TUTORIAL AND RETURN TO COMMAND MODE 
HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... _ 


Compiling your program 


wm wr 





The action initiated by each of these selections is explained under 
screen 3-10. For your purposes, choose number 2, EXECUTE THE 
PROGRAM, to execute your program. 


Program effects The result of this program is: 





DATE 81/11/18 TIME 10:04:21 ~--SYSTEM 80 - ESCORT DATA LISTING-- PAGE 001 


ACCTNO: 7483219 CRLIM: 709.99 CUSTNAME: LYKTA SPENDMONEY CUSTADDR: 8857A INDEBT ROAD 
CITY: BASTILLE STATEABB: DE ZIP: 14832 


ACCTNO: 2999478 CRLIM: 19,900 CUSTNAME: 
CITY: PAMPERED STATEABB: NY ZIP: 72782 


ACCTNO: 3456789 CRLIM: 5999.99 CUSTNAME: 
CITY: PROMPTLY STATEABB: NY ZIP: 99876 


ACCTNO: 1234567 CRLIM: 1990.99 CUSTNAME: DAVID J. PARALOVER 
CITY: HATFIELD STATEABB: PA ZIP: 19449 


ACCTNO: 2345678 CRLIM: 2999.09 CUSTNAME : 
CITY: BIRDSBORO STATEABB: PA ZIP: 19444 


O 
O 
O 
O 
O 
O 
O 
O 
O 
Oo 
O 
O 
O 
O 
Oo 
O 
Oo 
O 
O 
O 
O 
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3.12. DELETING DATA FROM THE WORKSTATION 


When you delete data from the workstation, each record (if you 

Purpose have an unkeyed file) or the key fields in each record (if you have a 
keyed file) are displayed on the workstation. For this example, 
we're using a keyed file. 


With a keyed file, the key field prompt is displayed on the 
Keyed files workstation, you enter the key data for the record you want 
deleted, and the record is marked for deletion. 


You enter tutorial mode in the method outlined in 3.3. When you 
get to the function screen (screen 3-2), you choose number 4, 
DELETE DATA. 


To choose DELETE DATA BY SELECTING FROM WORKSTATION, 
key in number 1 on screen 3-46 and press the XMIT key: 


SCREEN 
3-46 





* DELETE DATA FUNCTION ENABLED ° 


SELECT ONE OF THE FOLLOWING OPTIONS TO DELETE 
THE DATA IN YOUR FILE: 

1. DELETE DATA BY SELECTING FROM WORKSTATION 
DELETE DATA WITH CONDITIONS (‘IF'’ CLAUSE) 
- HELP - EXPLANATION OF OPTIONS 


*“ ENTER SELECTION NUMBER ... [1 | 


Selecting method of 


deletion 2. 
+ 3 





The next screen, screen 3-47, asks you to name the file from 
which you want to delete records. Because we'll use the same file 
we created in 3.5, key in the name CUSTACCT. 

DELETE MASTER 


SCREEN F 
3.47 
* FILE SPECIFICATION * 


ENTER THE NAME OF THE FILE, CONFORMING TO THE FOLLOWING RULES: 
~ THE FILENAME MAY BE FROM 1 TO 44 CHARACTERS LONG. 


~ BASICALLY, ONLY LETTERS (A-Z), NUMBERS (8-9), AND THE 
CHARACTERS SLASH (/) AND PERIOD (.) MAY BE USED. THE 
FIRST CHARACTER MUST BE A LETTER, AND EMBEDDED BLANKS 
ARE NOT ALLOWED. S 
- ¥F THE FILENAME 1S ENCLOSED IN DOUBLE QUOTES ("). ANY : 
CHARACTER EXCEPT A SINGLE QUOTE (') OR A DOUBLE QUOTE : 
MAY BE INCLUDED, AND EMBEDDED BLANKS ARE ALLOWED. 


EXAMPLES: PAYROLL 
XYZCO/PAYABLES, TAXES 
“ INVENTORY MASTER FELE” 


° ENTER A VALID FILENAME ... (ope Yet] - 





Naming the file 
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ESCORT search At this point, ESCORT searches the session and library files to find 
the structure with the same name as the first eight characters of 
your file name. 


Choose selection 1 on the following screen (screen 3-48) to use 
the existing CUSTACCT structure. 


SCREEN 
3-48 


A STRUCTURE EXISTS FOR THE FILE YOU HAVE NAMED. INDICATE 
HOW YOU WISH TO PROCEED: 

1. USE THE EXISTING STRUCTURE FOR THIS FILE 

2. USE A PREVIOUSLY-DEFINED ALTERNATE STRUCTURE 

3. KEY IN AN ALTERNATE STRUCTURE NOW 

4. HELP - EXPLANATION OF OPTIONS 


* ENTER SELECTION NUMBER ... 1 | 





“ FILE STRUCTURE SPECIFICATION * 





+ 


Because we chose to delete from the workstation, there are no 
conditions or clauses to key in, so the next screen asks if you want 
to name your program. For this example we won't, so we choose 2, 
NO - CONTINUE TUTORIAL SESSION, on screen 3-49: 
SCREEN 
3 49 
REFERENCE AND PROGRAM MODE MAINTENANCE, YOU MAY 
WISH TO IDENTIFY YOUR PROGRAM WITH A SPECIFIC 
Naming the program NAME. 
CHOOSE ONE OF THE FOLLOWING OPTIONS: 
1. YES - NAME THE PROGRAM 
2. NO - CONTINUE TUTORIAL SESSION 


3. HELP - EXPLANATION OF NAMING A PROGRAM ; ~<~ 
* ENTER SELECTION NUMBER ... a 








THE PROGRAM YOU HAVE GENERATED WILL BE THE 
RESIDENT PROGRAM CALLED ‘RESIDENT’. FOR FUTURE 


The next screen (screen 3-50) displays your completed ESCORT 
program: 


SCREEN 
3-50 





COMPLETED ESCORT PROGRAM IS AS FOLLOWS: 


DELETE DATA OF 
CUSTACCT ~<~— 
FROM WS 


Program compilation 


* DEPRESS XMiT TO COMPILE ABOVE PROGRAM ... es 
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Program operation 


Deleting the record 


Terminating deletion 
operation 
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When you press the XMIT key to compile your delete data 
program, the following decision screen (screen 3-51) appears: 


mem SCREEN §& - 
3-51 





* ESCORT PROGRAM COMPLETED ° 
WHAT WOULD YOU LIKE TO DO NEXT? 
SELECT ONE OF THE FOLLOWING OPTIONS: 
1. SAVE THE PROGRAM 
EXECUTE THE PROGRAM 
CREATE ANOTHER PROGRAM IN TUTORIAL MODE 
TERMINATE TUTORIAL AND RETURN TO COMMAND MODE 
HELP ~ EXPLANATION OF OPTIONS 
* ENTER SELECTION NUMBER ... _ 


new rv 





The action initiated by each of these options is listed under screen 
3-10. For your purposes, choose number 2, EXECUTE THE 
PROGRAM, to execute your program. Because your file is a keyed 
file and its key field is ACCTNO, the following prompt is displayed 
on your workstation screen: 







ACCTNO 


Suppose you want to delete the record for customer Lykta 
Spendmoney. The account number for that customer’s record is 
7483210. You key in that account number and press the XMIT key, 
and the record is marked for deletion. Then the prompt reappears, 
and you can key in the account number for the next record you 
want deleted. 


When you've entered all the account numbers for the records you 
want to delete, press the FUNCTION and F4 keys to specify the 
end of input to the system. 


Now that we’ve gone over some of the file operations you can 


perform in tutorial mode, let’s look at how these same operations 
function in program mode. 





CONCEPTS OF PROGRAM MODE 
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4. Interactive Program Mode 


4.1. WHY USE PROGRAM MODE? 


Advantages 


Entry methods 


Screen menu method 


Advantages 


Direct entry method 
Advantages 


Selection 


Intended user 


Program mode is the heart of ESCORT, and it’s the mode you'll use 
once you master tutorial mode. Unlike tutorial mode, which is 
limited in scope, program mode provides full ESCORT capability for 
all your problem-solving needs. It’s faster than tutorial mode, and it 
provides you with two methods of program entry: 


1. The screen menu method 
2. The direct entry method 


The screen menu method is similar to tutorial mode, but not as 
elementary. In tutorial mode, ESCORT creates your program; in 
program mode, you're in charge. ESCORT guides you in statement 
syntax and organization by providing the menu selections, but it’s up 
to you to pick the program statements and clauses needed to 
produce the desired results in your program. The screen menu 
method allows full ESCORT capability, but eliminates the need to 
memorize statement syntax and organization because you ‘‘write”’ 
your program from a series of screen menus. The screen menu 
method is described in 4.3 through 4.21. 


The direct entry method has the same ESCORT capability as the 
screen menu method, but it’s faster if you are familiar enough with 
ESCORT not to need menu guidance. You choose this method from 
the PROGRAM STATEMENTS menu (Figure 1-1b) by selecting 
choice number 6, DIRECT ENTRY OF PROGRAM STATEMENTS - 
FREE FORMAT. A blank screen then appears, and you key in 
program statements and clauses to meet your needs. You must be 
experienced with ESCORT programming before attempting this 
method because you're responsible for statement syntax and 
organization. Direct entry of program statements is discussed 
further in 4.22. 
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The following subsections discuss both methods and show you 
how to use them. The rest is up to you. For ease of use and 
minimum effort, the screen menu method is ideal. For speed, the 
direct entry method is best. But regardless of which method you 
use, ESCORT provides you with the same ease of use and 
versatility. Only you can determine how to use it to your best 
advantage. 


4.2. THINGS YOU NEED TO DO BEFORE ENTERING PROGRAM MODE 


Handling uncataloged files 


Entering ESCORT 


Regardless of which program mode method you use, there are 
three steps to follow before you can create a data file. This is 
important now because you must perform step 1 before you enter 
ESCORT. For our purposes, we'll assume your system is active and 
you've logged on. You must perform the following steps: 


Step 1: Make Sure the Files You Need Are Cataloged 


Files are cataloged using OS/3 job control statements. In most 
cases, the data files you use will already be allocated and 
cataloged. However, if you are in an ESCORT session and try to 
create a file that isn’t cataloged, you'll get an error message. To 
catalog a file, press the FUNCTION and SYS MODE keys. This 
puts you into system mode and you can run the job control stream 
to catalog the file. To get back to your ESCORT session, press the 
FUNCTION and WS MODE keys. For more information on 
cataloging files, see 6.3. 


Step 2: Enter ESCORT 
Enter ESCORT by keying in the word ESCORT and pressing the 


XMIT key. When you do this, the introductory screen (Figure 1-1a) 
appears, welcoming you to ESCORT. 


Pick the mode you want by keying in a selection number and 
pressing the XMIT key. Then, the command selection menu (Figure 
1-1a) appears, and you choose the command type you need. 


If you need a review on calling ESCORT, see 2.3. 
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Step 3: Create a Structure 


All data files must have a structure. To create a file structure, you 
must access the ESCORT structure processor by choosing number 
3, STRUCTURE COMMANDS, on the command selection menu 
(Figure 1-1a). Then, when the STRUCTURE COMMANDS menu 
appears, choose number 1, ENTER STRUCTURE, and enter a 
structure. 


If you need additional assistance or explanations, refer to Section 6. 


For purposes of example in this section, use the following 
structure, named INVNTORY: 


STRUCTURE OF INVNTORY EXPLANATION OF FIELD NAMES 


Product number 

Product description 

Unit size 

Cost of unit 

Retail markup 

Retail selling price 
Quantity on hand 
Quantity on order 

Reorder level 

Quantity discount percentage 
Vendor name for reorder 
Vendor address for reorder 
Vendor zip code 








While you're still on the STRUCTURE COMMANDS menu, it’s a 
good idea to save the structure you just created. This ensures that 
it is in the ESCORT library for future use. To save a structure, 
choose number 3 on the STRUCTURE COMMANDS menu, name 
the structure you want saved (INVNTORY), and press the XMIT key. 


When you're through creating and saving your structure, terminate 
the structure processor by choosing number 10, TERMINATE 
STRUCTURE PROCESSOR, on the STRUCTURE COMMANDS menu 
(Figure 1-1a). 


The command selection menu (Figure 1-1a) then reappears, and 
you can choose another command type. 
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The previous paragraph left you at the COMMANDS SELECTION 
menu. Since you already created a structure for your file, it’s time 
to enter a program. Select choice number 2, PROGRAM 
COMMANDS, from the COMMAND SELECTION menu and press 
the XMIT key. Remember, unless you're told otherwise, you must 
press the XMIT key after every entry to send your responses to the 
system. 


Now the following menu (screen 4-1) is displayed: 


SCREEN FE. 
4-1 





PROGRAM COMMANDS 


1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 

6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 
SELECT COMMAND f]_ PROGRAM NAME 


Because you want to enter a program, choose number 1, ENTER 
PROGRAM. Assigning a program name is not required unless you 
plan to save the program. If you: don’t name it, ESCORT assigns it 
the name RESIDENT. The examples in this section use RESIDENT 
except for the second CHANGE DATA example (CHANGE DATA 
replacing) and the SELECT DATA program example, which y 
save. 





Then the following menu (screen 4-2) appears: 


oe Clam aoa 
pa SCRE! 


1. ENTER DATA 
2. CHANGE DATA 
3. SELECT DATA 
4. DELETE DATA 
5 
6 
7 





PROGRAM STATEMENTS 


. SORT DATA 
. DIRECT ENTRY OF PROGRAM STATEMENT - FREE FORMAT 
. HELP - EXPLANATION OF STATEMENT FORMAY CORVERTIONS 


SELECTION - 





This screen lists each type of program statement, and you pick the 
one you want. 
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At this point, your ESCORT program mode session can take many 
paths, depending on which program statement you choose. The 
specific uses and complete formats for the program statements 
appear in Section 7. For now, concern yourself only with the 
sequence of the screen menus and the choices you make to get 
the desired clauses and statements for your program. 


Examples of each type of program statement are given in 
subsequent subsections, beginning with the ENTER DATA program 
statement. 


It is important to note that any data shown as entered into files or 
displayed or printed as output is variable data keyed into our files 
for purposes of example. Obviously, your data will be different, but 
just assume that all the data we keyed in exists on our file and is 
output as such. 
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4.4. USING THE SCREEN MENU METHOD TO CREATE TWO KINDS OF DATA 
ENTRY PROGRAMS 


Using the structure created in 4.2, you can write a data entry 
program by using one of two data entry methods: 


Data entry methods a CREATING - to create new files 


w EXTENDING - to extend existing files 


4.5. CREATING A NEW DATA FILE 


Since this is your first program mode session, you'll want to create 
Entering data a data file, so key in number 1, ENTER DATA, on the PROGRAM 
STATEMENTS menu (screen 4-2). 


Since you picked ENTER DATA, the screen containing the format of 
the basic ENTER DATA program statement is displayed (screen 
4-3). (We'll give you more information on the basic ENTER DATA 
statement in 7.5.) 


an CLG Gee 
ie 





ENTER DATA STATEMENT 


ENTER DATA FROM WS (structure-name) 
(structure-name, formname) 

structure-name AND formname ARE OPTIONAL PARAMETERS 

TF formname USED, MUST ALSO INCLUDE structure-name 


KEYIN PARAMETERS 





ENTER DATA 


program statement structure-name formname 


Parameter keyin You'll notice that both the structure-name and the _ structure- 

name,formname parameters are optional. The structure-name 
Structure-name parameter is only optional, however, when the name of the 
parameter structure is the same as the first eight characters of the file name. 


When the names are not the same, you must assign a structure 
name, or you'll get an error. 


Structure-name,formname The structure-name,formname parameter is used only when you 
parameter want to designate a form on which to input your data. In this case, 
the structure-name parameter is also required. 
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File and structure names 


Clause decisions 


CREATING clause 


Specifying output file 
and structure names 
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Because the sample structure is named INVNTORY, name your file 
INVNTORY also. Because they both have the same name, you don't 
have to specify the structure-name parameter. Press the XMIT key 
to move to the next screen. 


The next screen (screen 4-4) lists all the clauses applicable to the 
ENTER DATA program statement: 


SCREEN 
4-4 





SELECT NEXT CLAUSE FOR ENTER DATA STATEMENT 


1. WORKAREA clause 10. OUTPUT TO PRINTER clause 

2. IF clause 11. OUTPUT TO WS clause 

3. WHILE clause 12. CREATING clause 

4. COMPUTING clause 13. EXTENDING clause 

5. CLEARING clause 14. EXIT clause 

6. SUBTOTALING clause 15. DISPLAY CURRENT PROGRAM BEING ENTERED 
7. TOTALING clause 16. DIRECT ENTRY OF CLAUSES 

8. PRINT clause 17. CANCEL LAST CLAUSE ENTERED 

9. DISPLAY clause 18. ENTER DATA STATEMENT COMPLETED 


SELECTION 





You pick the clause you want, and ESCORT displays it so you can 
key in the necessary parameters. 


Because this is your first session and your first data file, choose 
number 12, CREATING clause. ESCORT displays the screen (screen 
4-5) containing the format for the CREATING clause. 


. Benen oer 
4-5 
CREATING clause 


FUNCTION: CREATES A NEW FILE 
FORMAT: CREATING output-file (structure-name) 
KEYIN PARAMETERS 


output-file [RREROTR === = e 


structure-name 





For this clause, the only thing you are required to do is key in the 
output file name, which is INVNTORY, and press the XMIT key. 
You don't need to key in the structure name because it’s the same 
as the file name. 
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Statement completion 


Additional file 
processing 


Saving a program 


Program display 


Example program 
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ESCORT keeps track of what you key in and again displays the 
clauses screen (screen 4-4) so you can pick another clause. 
Because you're creating a new data file, you don't need any more 
clauses, so choose number 18, ENTER DATA STATEMENT 
COMPLETED. 


When ESCORT receives this statement, it compiles your program 
and displays the PROGRAM COMMANDS menu again (screen 
4-6). Now you can choose what you want to do with your program: 


PME SCREENT 
4-6 


. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

. RUN PROGRAM 8. REMOVE PROGRAM FORM LIBRARY 

. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 

. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 
SELECT COMMAND __ PROGRAM NAME 





PROGRAM COMMANDS 


Ann wnr oe 





If you think you'll want to reuse your program (which is unlikely in 
the case of file creation), save it by choosing number 6, SAVE 
PROGRAM. ESCORT then displays the corresponding sequence of 
screens you must complete to save your program. 


To get an idea of what your completed program looks like, choose 
number 4, DISPLAY PROGRAM. Because you used the system- 
supplied name (RESIDENT), you don’t have to key in a program 
name. Just pick your selection and press the XMIT key, and 
ESCORT displays your data entry program: 


ENTER DATA FROM WS CREATING INVNTORY 





To get back to the PROGRAM COMMANDS menu (screen 4-6), 
press the XMIT key. 
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Program execution 


Default record format 
for data entry 










Sample input 
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Because your program is complete and you don’t want to save it, 
choose command number 2, RUN PROGRAM, and press the XMIT 
key. Because you used the system-supplied name (RESIDENT), you 
don’t have to key in a program name. ESCORT executes your 
program and, because you did not designate a specific input form, 
displays the default record template corresponding to the fields in 
your structure. You use this template for data entry. The default 
record template for the structure INVNTORY appears like this: 


PROONO 
PRODESC 
UNITSIZE 
UNITCOST 
MARKUP 


RETPRICE 


QONHAND 
QONORDER 
REORDERL 


QUANDISC 
VENDNAME 
VENDADDR 
VENDZIP 





Assuming you enter the following data into this template, your data 
record now looks like this: 


PRODNO RRAEELS/ 
PRODESC [ZU SN CaS ee SSS) 
UNITSIZE Pape, 
UNITCOST Eu 
MARKUP [RR 
RETPRICE MOS y 
QONHAND BRa) 
QONORDER My 
REORDERL ex) 
QUANDISC Baty 
VENONAME BLESS RESTS See a 
VENDADDR BOE Meee BE LE er eee eee 
VENOZIP BERET 
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Input termination 


Terminate program mode 


Terminate ESCORT session 
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By pressing the XMIT key, you can move from record to record 
until you finish entering data into your file. When your last record 
is entered, press the FUNCTION and F4 keys to designate the end 
of the input file. 


At this point, you now have a data file named INVNTORY, and 
ESCORT is displaying the PROGRAM COMMANDS menu (screen 
4-6). Your processing is complete, so choose number 12, 
TERMINATE PROGRAM COMMAND SELECTION. This displays the 
command selection menu and you choose number 1, TERMINATE 
CURRENT ESCORT SESSION. 


Now your data entry program is complete, you have a file named 
INVNTORY, and you can use any of the other program statements 
to manipulate or change this file. 


4.6. EXTENDING AN EXISTING DATA FILE 


Purpose 


Choosing ENTER 
DATA statement 


ENTER DATA 
statement 





Now that you have a data file, assume you want to add more 
records to it. You use the ENTER DATA program statement and the 
EXTENDING clause. The process is the same as in 4.5 (where you 
used the CREATING clause) up to the clauses screen, where you 
choose the EXTENDING clause rather than the CREATING clause. 


We'll assume you've chosen the ENTER PROGRAM command from 
the PROGRAM COMMANDS menu (screen 4-1) and are now at 
the PROGRAM STATEMENTS menu (screen 4-2). 


To begin, choose number 1, ENTER DATA, on the PROGRAM 
STATEMENTS menu (screen 4-2). The screen containing the basic 
ENTER DATA statement (screen 4-7) is displayed, and you fill in 
the required parameters. The required parameters were outlined 
earlier in 4.5 (screen 4-3). 


? 4-7 





ENTER DATA STATEMENT 
ENTER DATA FROM WS) (structure-name) 
{structure-name,formname ) 
structure-name AND formname ARE OPTIONAL PARAMETERS 
tF formname USED, MUST ALSO INCLUDE structure-name 
KEYIN PARAMETERS 


structure-name formname 
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File and structure 
name entry 


Selecting the 
EXTENDING clause 


Naming the output 
file 


Additional clause 
choices 


Statement completion 
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Because your file and structure name are the same, you don’t need 
to key in any parameters on this screen (they will be named in the 
EXTENDING clause), so press the XMIT key to proceed. 


The next screen (screen 4-8) lists the clauses applicable to the 
ENTER DATA program statement: 


ME SCREEN 
4-8 






SELECT NEXT CLAUSE FOR ENTER DATA STATEMENT 


1. WORKAREA clause 10. OUTPUT TO PRINTER clause 

2. IF clause 11. OUTPUT TO WS clause 

3. WHILE clause 12. CREATING clause 

4. COMPUTING clause 13. EXTENDING clause 

5. CLEARING clause 14. EXIT clause 

6. SUBTOTALING clause 15. DISPLAY CURRENT PROGRAM BEING ENTERED 

7. TOTALING clause 16. DIRECT ENTRY OF CLAUSES 

8. PRINT clause 17. CANCEL LAST CLAUSE ENTERED 

9. DISPLAY clause 18. ENTER DATA STATEMENT COMPLETED 
SELECTION BER 





Because you want to add records to an existing file, choose 
number 13, EXTENDING clause. ESCORT then displays screen 4-9, 
which contains the format for the EXTENDING clause: 


SCREEN — 
4-9 


FUNCTION: ADOS RECORDS TO AN EXISTING FILE 
FORMAT: EXTENDING output-file (structure-name) 
KEYIN PARAMETERS 


output-file PRRBRMe = 


structure-name 





EXTENDING CLAUSE 


For this clause, you're only required to key in the output file name, 
which is INVNTORY, and press the XMIT key. You don’t need to 
key in the structure name because it’s the same as the file name. 


ESCORT keeps track of what you key in and redisplays the clauses 
screen (screen 4-8) so you can pick another clause. 


Because you're extending an existing data file, you don’t need any 
more clauses, so choose number 18, ENTER DATA STATEMENT 
COMPLETED. 
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Program compilation 


Saving a program 


Program display 


Example program 
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When ESCORT receives this statement, it compiles your program 
and displays the PROGRAM COMMANDS menu (screen 4-10): 


Sess ge 
4-10 





PROGRAM COMMANDS 





1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM WAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 

6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 
SELECT COMMAND _ PROGRAM NAME 


If you think you'll want to reuse your program, you can save it by 
choosing number 6, SAVE PROGRAM, and ESCORT displays the 
corresponding sequence of screens you must complete to save 
your program. 


If you want to get an idea of what your completed program looks 
like, choose number 4, DISPLAY PROGRAM. Because you used the 
system-supplied name (RESIDENT), you don't have to key in a 
program name. Just pick your selection and press the XMIT key, 
and ESCORT displays your file extension program: 







ENTER DATA FROM WS EXTENDING INVNTORY 


To get back to the PROGRAM COMMANDS menu (screen 4-10), 
press the XMIT key. 
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Because your program is complete and you don’t want to save it, 

Program execution choose command number 2, RUN PROGRAM. Because you used 
the system-supplied name, RESIDENT, you don’t need to key in a 
program name, so just press the XMIT key. ESCORT executes your 
program and, because you did not designate a specific input form, 
displays the default record template corresponding to the fields in 
your structure: 


PRODNO 
PRODESC 
UNITSIZE 
UNITCOST 
MARKUP | 
Default record RETPRICE 
format for { — QONHAND 
data entry © = Qonorver 
| —sOREORDERL _ 
|  QUANDISC 
@ | VENDNAME 
VENDADDR 
VENDZIP 





Entering data records Then, just as when you created your file, you enter records into 
this template. By pressing the XMIT key, you can move from record 
to record until you finish entering data into your file. When your 
last record is entered, press the FUNCTION and F4 keys to 
designate the end of the input file. 


At this point, you have successfully added records to your data file 
INVNTORY, and ESCORT is displaying the PROGRAM COMMANDS 
File extension menu (screen 4-10). Your processing is complete, so choose 
complete number 12, TERMINATE PROGRAM COMMAND SELECTION. This 
displays the command selection menu, and you choose number 1, 
TERMINATE CURRENT ESCORT SESSION. 


Now your file extension program is complete, and you can perform 
other operations on your file by using the other program 
statements. 
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4.7. USING THE SCREEN MENU METHOD TO CREATE THREE KINDS 
OF DATA CHANGE PROGRAMS 


Now that you created a data file (INVNTORY) and entered data into 
Purpose it, you can write a data change program by using the CHANGE 
DATA program statement. 


There are three ways to use the CHANGE DATA statement: 
Data change methods # Change data from the workstation 
= Change data by assigning new field values 


= Change data by replacing with matching file data 


4.8. CHANGE DATA FROM THE WORKSTATION 


Example definition Using the data file and structure you created in 4.5, your first data 
change program changes the vendor address (VENDADDR) and 
vendor zip code (VENDZIP) fields of your INVNTORY file. 


We'll assume you've chosen the ENTER PROGRAM command from 
the PROGRAM COMMANDS menu (screen 4-1) and are now at 
the PROGRAM STATEMENTS menu (screen 4-2). 


Initiation of CHANGE To get the CHANGE DATA function, choose number 2 on the 
DATA PROGRAM STATEMENTS menu (screen 4-2). 


This displays screen 4-11, which contains the format of the basic 
CHANGE DATA statement. (We'll give you more information on the 
basic CHANGE DATA statement in 7.8.) 


SCREEN : 
4-11 CHANGE DATA STATEMENT 


CHANGE DATA OF file-m (structure-m) (FROM <file-i (structure-i)> ) 
{ <WS (structure-i)> ) 
( <WS (structure-i,formname)>) 

FROM clause, structure-names and formname ARE OPTIONAL PARAMETERS 

file-m |S NAME OF DATA FILE BEING CHANGED 

file-i tS NAME OF FILE CONTAINING CHANGE CRITERIA 

bF WORKSTATION USED AS CHANGE CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i parameter 


KEYIN PARAMETERS 





Wy elm 42 Sie Se ee ees i od Go Ee Structure-m 


BLN Sy 1s Sheet ese an oh whe et SA hes gt col Aes ts ny A ed es structure-i 9 


formname 
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Required parameters 


Parameter keyin 


Clause decisions 











Notice that the only required parameter is file-m. This names the 

file you want to change (INVNTORY, for this example). Again, the 
Structure-name parameter is optional. You use it only when the 
structure name is different from the first eight characters of the file + 
name or when you use the structure-name,formname parameter to 
designate a customized input form. 


For this example, fill in the file-m parameter with the file name 
INVNTORY and, because you're using the workstation for input, key 
in WS for the file-/ parameter. Your CHANGE DATA screen now 


looks like screen 4-12: 


SCREEN 
4-12 


KEYIN WS FOR file-i parameter 
KEYIN PARAMETERS 


CHANGE DATA STATEMENT 
CHANGE DATA OF file-m (structure-m) (FROM <file-i (structure-i)}> 


FROM clause, structure-names and formname ARE OPTIONAL PARAMETERS 
file-m 1S NAME OF DATA FILE BEING CHANGED 

file-i 1S NAME OF FILE CONTAINING CHANGE CRITERIA 

IF WORKSTATION USED AS CHANGE CRITERIA DEVICE, THEN 






) 
( <WS (structure-i)> ) 
( <WS (structure-i,formname)>) 


structure-m 
structure-i 


formname 


Once your CHANGE DATA screen is completed, press the XMIT 
key to proceed. The next screen (screen 4-13) lists all the clauses 
applicable to the CHANGE DATA statement: 


SCREEN 
4-13 


SELECTION __ 


1. USENG clause 10. 
2. WORKAREA clause li 
3. IF clause 12. 
4. WHILE clause 13. 
5. COMPUTING clause 14. 
6. CLEARING clause 15 
7. SUBTOTALING clause 16. 
8. TOTALING clause 17. 
9. PRINT clause 





SELECT NEXT CLAUSE FOR CHANGE DATA STATEMENT 


DISPLAY clause 

OUTPUT TO PRINTER ciause 

OUTPUT TO WS clause 

EX!T clause 

DISPLAY CURRENT PROGRAM BEING ENTERED 
DIRECT ENTRY OF CLAUSES 

CANCEL LAST CLAUSE ENTERED 

CHANGE DATA STATEMENT COMPLETED 





UP-8855 Rev. 1 








Statement completion 


Statement compilation 


Program display 


Program execution 
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Because you're using the workstation for input, you really don't 
need any other clauses, so pick number 17, CHANGE DATA 
STATEMENT COMPLETED. 


When ESCORT receives this statement, it compiles your program 
and displays the PROGRAM COMMANDS menu (screen 4-14). 
Now you can choose what you want to do with your program. 





SCREEN 
4-14 
PROGRAM COMMANDS 
1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 
2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 
3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 
4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 
5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 
6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 
SELECT COMMAND PROGRAM NAME 





Again, as with all programs, you have the option to save your 
program. Because you're only changing addresses of specific 
vendors, it’s unlikely you’ll want to use it again, so don't save it. 


To get an idea of what your finished program looks like, select 
number 4, DISPLAY PROGRAM, and press the XMIT key. Then 
ESCORT displays your program: 


CHANGE DATA OF INVNTORY FROM WS 





To get back to the PROGRAM COMMANDS menu (screen 4-14), 
press the XMIT key. 


Then choose number 2, RUN PROGRAM, on screen 4-14 to 
execute your program. 
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At this point, depending upon what type of file you're attempting to 
change, keyed or unkeyed, your program can take two paths. The 
program for this example is for a keyed file. 


Keyed files = tf Your File Is Keyed 


Example When you use a CHANGE DATA FROM WS program on a 
keyed file, a prompt containing the key field name and blank 
spaces appears. The key field name for this example is product 
number (PRODNO). 


Keyed file display 4 PRODNO 
prompt - 





Key in the product number of the record you want to change 
© (e.g., 1234567), and ESCORT displays the rest of the record. 
The record for this product number appears: 


PRODNO 1234567 
PRODESC PARAKEET BIRDSEED 
: UNITSIZE CASE/12 
Keyed file . UNITCOST 8.48 
record display - MARKUP 6.39 
RETPRICE 18.92 
QONHAND 125 
QONORDER 
REORDERL 59 
QUANDISC 8.92 
VENDNAME HATFIELD SEED CORP. 
VENDADDR 1234 ALLENTOWN ROAD, HATFIELD, PA. 
VENOZIP 19448 





Now you simply key in the data you're changing for the fields 
File updated VENDADDR and VENDZIP and press the XMIT key, and your 
file is automatically updated. 
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ESCORT 
Unkeyed files 2 ‘If Your File ls Unkeyed 
Three types There are three types of unkeyed files: 


1. Unkeyed, unordered file with no matching criteria 
2. Unkeyed, unordered file with matching criteria 

3. Unkeyed, sorted file with matching criteria 

When you use: 

-  Unordered File with No Matching Criteria 


ESCORT action ESCORT displays every record on the workstation for 
change. 


- _Unordered File with Matching Criteria 


ESCORT action ESCORT displays the prompt for each field designated as 
a matching field on the workstation. Then you key in the 
data for the prompted field of the record you want to 
change. 


ESCORT reads the file from beginning to end and displays 
each record that matches the prompt field, so you can 
make your changes. 


When you complete your changes, press the FUNCTION 
and F4 keys to specify the end of input to your system. 


- Sorted File with Matching Criteria 


ESCORT action ESCORT displays the matching field prompt on the 
workstation, and you key in the data for that field. 
ESCORT then searches the file for a matching record. 
Then the record is displayed on the workstation for 
change. After you make all your changes, press the 
FUNCTION and F4 keys to specify the end of input to 
your system. 
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4.9. CHANGE DATA BY ASSIGNING NEW FIELD VALUES 


Using the data file and structure (INVNTORY) created in 4.5, your 

Program objective second data change program changes the value of the field 
MARKUP. Also, it computes a new retail price (RETPRICE) by 
multiplying the fields UNITCOST and MARKUP and adding the 
value of UNITCOST. It then prints a report, using the standard 
system formatting PRINT clause. 


We'll assume you've chosen the ENTER PROGRAM command from 
the PROGRAM COMMANDS menu (screen 4-1) and are now at 
the PROGRAM STATEMENTS menu (screen 4-2). 


Initiation of CHANGE DATA To get the CHANGE DATA function, choose number 2 on the 
PROGRAM STATEMENTS menu (screen 4-2). 


This displays screen 4-15, which contains the format of the basic 


CHANGE DATA statement. (We'll give you more information on the 
@ basic CHANGE DATA statement in 7.8.) 


SCREEN F-_ ears 
4-15 
CHANGE DATA STATEMENT 





CHANGE DATA OF file-m (structure-m) (FROM <file-i (structure-i)}> ) 
( <wS (structure-i)> ) 
( <WS (structure-i,formname)>) 


FROM clause, structure-names and formname ARE OPTIONAL PARAMETERS 
file-m (S NAME OF DATA FILE BEING CHANGED 

file-i tS NAME OF FILE CONTAINING CHANGE CRITERIA 

CHANGE DATA 1F WORKSTATION USED AS CHANGE CRITERIA DEVICE, THEN 

statement KEYIN WS FOR file-i parameter 


KEVIN PARAMETERS 


file-m structure-m 


file-i structure-i 


formname 


Parameter keyin Notice that the only required parameter is the file-m specification. 
This names the file you want to change (INVNTORY, for this 
example). 


Structure-name parameter Again, the structure-name parameter is optional. You use it only 

when the structure name is different from the first eight characters ~~ 
Structure-name,formname of the file name or when you use the structure-name,formname 
parameter parameter to designate a customized input form. 
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For this example, fill in the file-m parameter with the file name 
INVNTORY. Your CHANGE DATA screen now looks like screen 





4-16. | 
pea SCREEN 
ae CHANGE DATA STATEMENT 
CHANGE DATA OF file-m (structure-m) (FROM <file-i (structure-i)> ) 
( <WS (structure-i)> ) 
( <WS (structure-i, formname)>) 


FROM clause, structure-names and formname ARE OPTIONAL PARAMETERS 
file-m |S NAME OF DATA FILE BEING CHANGED 

file-i 1S NAME OF FILE CONTAINING CHANGE CRITERIA 

1F WORKSTATION USED AS CHANGE CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i parameter 


KEYIN PARAMETERS 


Completed CHANGE 
DATA screen 


file-m [ERR structure-m 
PAO Se te et oe a Se a ee structure-i 
formname 





Clause decisions Once your CHANGE DATA screen is completed, press the XMIT 
key to proceed. The next screen (screen 4-17) lists all the clauses @ 
applicable to the CHANGE DATA statement: 





SCREEN 
4-17 








SELECT NEXT CLAUSE FOR CHANGE DATA STATEMENT 


1. USING clause 10. DISPLAY clause 
2. WORKAREA clause 11. OUTPUT TO PRINTER clause 
3. IF clause 12. OUTPUT TO WS clause 
* 4. WHELE clause 13. EXIT clause 
Selecting the 5. COMPUTING clause 14. DISPLAY CURRENT PROGRAM BEING ENTERED 
COMPUTING clause 6. CLEARING clause 15. DIRECT ENTRY OF CLAUSES 
7. SUBTOTALING clause 16. CANCEL LAST CLAUSE ENTERED 
8. TOTALING clause 17. CHANGE DATA STATEMENT COMPLETED 
9. PRINT clause 





serection BJ 


Because you want to specify a new value for the field MARKUP, 
choose number 5, COMPUTING clause. 
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COMPUTING clauses 


Clause selection 


Select COMPUTING 
clause 
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The screen containing the format for the COMPUTING clause 
appears (screen 4-18), and you key in your data replacement state- 
ment. 


SCREEN 
4-18 





COMPUTING CLAUSE 
FUNCTION: PROVIDES A CALCULATE AND STORE CAPABILITY. 
FORMAT: COMPUTING data replacement statements 
KEYIN DATA REPLACEMENT STATEMENTS 


When you complete this clause, press the XMIT key. The CHANGE 
DATA clauses screen reappears (screen 4-17), and you select 
another clause for your program. 


Because you also want to compute a new retail price (RETPRICE), 
choose number 5, COMPUTING clause, again. The COMPUTING 
clause screen reappears (screen 4-19), and you key in another data 
replacement statement. 


SCREEN 
4-19 





COMPUTING CLAUSE 
FUNCTION: PROVIDES A CALCULATE AND STORE CAPABILITY. 
FORMAT: COMPUTING data replacement statements 
KEYIN DATA REPLACEMENT STATEMENTS 


COMPUTING DXSe cake SU CRS hee CT cee ha 


When you press the XMIT key, the CHANGE DATA clauses screen 
reappears (screen 4-17), and you select another clause. 
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PRINT clause Because you want to print a report of the new prices, choose 
number 9, PRINT clause. When the PRINT clause screen appears 
(screen 4-20), key in the parameter you want. | 


4-20 





PRINT clause 


FUNCTION: LISTS TO THE PRINTER, USING AUTOMATIC FORMATTING, A DATA RECORD; 
OR SELECTED DATA FIELDS AND LITERAL ‘EXPRESSIONS; OR THE TOTALING 
DATA FIELDS; OR THE SUBTOTALING DATA FIELDS. 


FORMAT: PRINT (<structure-name> ) 


(<field-names, ‘‘literal expressions’ '>) 
(<SUBTOTALS> ) 
(<TOTALS> ) 


KEYIN ONLY ONE OR NONE OF THE FOLLOWING: 
1. STRUCTURE NAME ENCLOSED IN PARENTHESES ({ ) 
2. FIELD NAME AND LITERAL EXPRESSIONS 
3. THE WORD - SUBTOTALS 
4. THE WORD - TOTALS 


PRINT S20 ate ERE d ee ee 








Statement completion When you complete this clause screen, press the XMIT key to 
proceed. The CHANGE DATA clauses screen is redisplayed (screen 
4-17). Because you're finished with the CHANGE DATA program 
keyin, pick number 17, CHANGE DATA STATEMENT COMPLETED. 


Program compilation When ESCORT receives this statement, it compiles your program 


and displays the PROGRAM COMMANDS menu (screen 4-21). { 
Now you can choose what you want to do with your program. 


SCREEN i 
4-21 PROGRAM COMMANDS 





1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 

6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 
SELECT COMMAND __ PROGRAM NAME 


SAVE PROGRAM option Again, as with all programs, you have the option to save your 
program. Because this program assigns a specific value to a field 
(MARKUP), it’s unlikely that you'll want to use it again, so don't save 
it. 








UP-8855 Rev. 1 SPERRY UNIVAC OS/3 4-23 
ESCORT 





Program display So you can get an idea of what your finished program looks like, 
select number 4, DISPLAY PROGRAM, and press the XMIT key. 
Then, ESCORT displays your program. 






Example program 





CHANGE DATA OF INVNTORY 
COMPUTING MARKUP=6.35 

COMPUTING RETPRICE=(UNITCOST ° MARKUP) + UNITCOST 
PRINT PRODNO, PRODESC ,UNITSIZE,RETPRICE 







To get back to the PROGRAM COMMANDS menu (screen 4-21), 
press the XMIT key. 


Program execution Then, choose number 2, RUN PROGRAM, on screen 4-21 to 
execute your program. 


Because you elected to output your data by using the standard 
system formatting PRINT clause, ESCORT outputs your data in the 
following manner: 


Standard system 
output format 


ESCORT DATA LISTING 
PRODNO PRODESC UNITSIZE RETPRICE 


1234567 PARAKEET BIRDSEED CASE/12 
8765432 FLEE PUPPY COLLARS CASE/24 
7488939 W-M-M PUPPY CHOW SACK/251b. 
9567899 TICK-AWAY TICK COLLARS CASE/24 


OOOO0N0000 


oO 
O 
O 
O 
O 
O 
O 
O 
e) 





4.10. CHANGE DATA OF MASTER FILE BY REPLACING WITH MATCHING 


FILE DATA 
Another variation of the CHANGE DATA statement is to use it to 
change specific fields in your record by replacing them with new 
Creating a transactional data. To do this, you create a transactional file that contains the 
file fields you want to change. The CHANGE DATA program statement 


lets you replace the data in the master file with the data in the 
transactional file. 
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Sample program 


INVNTORY structure 


Using transactional 
files 


INVTRAN structure 


Sample program 
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To create a sample transactional file, use the structure (INVNTORY) 
listed in 4.2. To refresh your memory, the structure of INVNTORY is: 


STRUCTURE OF INVNTORY 


RETPRICE 
QONHAND 


QONORDER 
REORDERL 





Suppose you want to create a transactional file to change prices in 
your master inventory file. The first step is to create a structure con- 
taining the fields you want to change. For this example, use the 
structure INVTRAN. Then use an ENTER DATA program to create 
and input data into your transactional! file. Because PRODNO is a 
keyed field, ESCORT uses this field as the CHANGE criteria. 


The structure of INVTRAN is: 






STRUCTURE OF INVTRAN 







_| PRODNO 
| UNITCOST 4v2 


This example changes the UNITCOST field of selected records by 
matching the product number (PRODNO). When the PRODNO fields 
match, the UNITCOST field of INVNTORY is replaced by the UNIT- 
COST field of INVTRAN. After each replacement is performed, a new 
retail price (RETPRICE) for INVNTORY is computed by multiplying the 
new UNITCOST by the MARKUP field and adding the value of UNIT- 
COST. 
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Name the program 


CHANGE DATA 
program statement 


Clause decisions 


Selecting the 
COMPUTING clause 
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On the PROGRAM COMMANDS menu (screen 4-21), choose 
number 1, ENTER PROGRAM, and name your program. For this ex- 
ample, name it CHDATA. Using the structures specified, you then 
initiate the CHANGE DATA statement. To do this, choose number 2 
on the PROGRAM STATEMENTS menu (screen 4-2). 


This displays the screen containing the basic format for the 
CHANGE DATA statement (screen 4-22). Fill in the required 
parameters. In this case, you need to use the FROM clause because 
the changed data is being input from another file. 


SCREEN : 
ay) 
CHANGE DATA STATEMENT 


CHANGE DATA OF file-m (structure-m) (FROM <file-i (structure-i)> ) 
( <WS (structure-i)> ) 
( <WS (structure-i,formname) >) 

FROM clause, structure-names and formname ARE OPTIONAL PARAMETERS 

file-m |S NAME OF DATA FILE BEING CHANGED 

file-i |S NAME OF FILE CONTAINING CHANGE CRITERIA 

(F WORKSTATION IS USED AS CHANGE CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i parameter 


KEYIN PARAMETERS 





file-m [LRRRRAaE 8 structure-m 
file-i GRRABEIR Sstructure-i 20° 
formname 


Once you complete your CHANGE data screen, press the XMIT key 
to proceed. Then the clauses screen (screen 4-17) appears, listing 
all the clauses applicable to the CHANGE DATA statement. 


Because you also want to compute a new retail price (RETPRICE) 
after the specified UNITCOST fields are changed, you must specify 
the COMPUTING clause, selection 5. The COMPUTING clause 
screen for this example appears (screen 4-23): 


ml SCREEN J 
i 4-23 





COMPUTING CLAUSE 
FUNCTION: PROVIDE A CALCULATE AND STORE CAPABILITY. 


FORMAT: COMPUTING data replacement statements 
KEYIN DATA REPLACEMENT STATEMENTS: 
COMPUTING Daag ais {UNI TCOST ° MARKUP) ~ UNITCOST 
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ESCORT 
Additional clause When you complete this clause, press the XMIT key. The CHANGE 
selection DATA clauses screen reappears (screen 4-17). 


Because you want to print the new data in a report form, choose the 

Choosing the PRINT option system formatting PRINT clause, number 9 on the menu. This dis- 
plays the PRINT clause screen (screen 4-24), and you key in the 
parameters you want to use. 


SCREEN 
4-24 





PRINT clause 


FUNCTION: LISTS TO THE PRINTER, USING AUTOMATIC FORMATTING, A DATA RECORD; 
OR SELECTED DATA FIELDS AND LITERAL EXPRESSIONS; OR THE TOTALING 
DATA FIELDS; OR THE SUBTOTALING DATA FIELDS. 


FORMAT: PRINT (<structure-name> ) 


(<fieldnames, ‘‘iiteral expressions’ '>) 
(<SUBTOTALS> ) 
(<TOTALS> ) 


KEYIN ONLY ONE OR NONE OF THE FOLLOWING: 
1. STRUCTURE NAME ENCLOSED IN PARENTHESIS ( ) 
2. FIELD NAME AND LITERAL EXPRESSIONS 
3. THE WORD - SUBTOTALS 
4. THE WORD - TOTALS 


PRINT ESL CRU DR ce eee ee 





When you complete this clause, press the XMIT key to proceed. The 
CHANGE DATA clauses screen is redisplayed (screen 4-17). 

' Statement completion Because you're finished with the CHANGE DATA program keyin, 
pick number 17, CHANGE DATA STATEMENT COMPLETED. 


Program compilation When ESCORT receives this statement, it compiles your program 
and displays the PROGRAM COMMANDS menu (screen 4-25). 
Now you can choose what you want to do with your program. 


SCREEN 
4-25 





PROGRAM COMMANDS 


1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 
6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 


SELECT COMMAND __ PROGRAM NAME 
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Saving the program 


Program display 


Program example 


Program execution 
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Again, as with all programs, you have the option to save your 
program. Because this program can be used over and over again 
when you change your prices, it would be wise to save it. We'll 
give information on saving programs in 5.13. 


To get an idea of what your finished program looks like, choose 
number 4, DISPLAY PROGRAM, on screen 4-25; key in your 
program name (CHDATA), and press the XMIT key. Then ESCORT 
displays your program: 


CHANGE DATA OF INVNTORY FROM INVTRAN 


COMPUTING RETPRICE=(UNITCOST ° MARKUP) + UNITCOST 
PRINT PRODNO,UNITCOST,. RETPRICE 





To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Then choose number 2, RUN PROGRAM, on screen 4-25, to 
execute your program. 
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Program results 





The following records from the INVNTORY and INVTRAN file show 
how the data change program affects the file data. 


Three data records from INVNTORY: Two data records from INVTRAN: 


S oe 
















PRODNO 1234567 

PRODESC PARAKEET BIROSEED 

UNITSIZE CASE/12 

UNITCOST 8.40 

MARKUP 0.30 

RETPRICE 10.92 

QONHAND 125 

QONORDER 0 

REORDERL 50 

QUANDISC 0.02 

VENDNAME HATFIELD SEED CORP. 

VENDADDR 1234 ALLENTOWN ROAD HATFIELD, PA 
VENDZIP 19440 






PRODNO 1234567 
UNITCOST 9.00 








PRODNO 4567890 
UNITCOST 4.50 




















PRODNO 4567890 
PRODESC M-M-M PUPPY CHOW 

UNITSIZE SACK/25LB. 

UNITCOST 4.20 

MARKUP 0.30 

RETPRICE 5.46 

QONHAND 100 

QONORDER O 

REORDERL 20 

QUANDISC 0.00 

VENDNAME HOW NOW BROWN CHOW 
VENDADOR 86 LOVETT ST. TAMMYVILLE, DE 
VENDZIP 99685 














PRODNO 9783456 
PRODESC PARAKEET CAGES 

UNITSIZE CARTON/1 

UNITCOST 12.99 

MARKUP 0.30 

RETPRICE 16.88 

QONHAND 15 

QONORDER O 

REORDERL 5 

QUANDISC 0.00 

VENDNAME BIRDSBORO BIRD CO. 
VENDADDR 637 GREENE STREET PARA, PA. 
VENOZIP 58972 


Notice that only the records with the PRODNO (product number) 

1234567 and 4567890 are replaced with the data from INVTRAN. @ 
The third record of INVNTORY is not changed because there is no 

INVTRAN record requesting that it be changed. 
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The changed data records now look like this: 


PRODNO 1234567 

PRODESC PARAKEET BIRDSEED 
UNITSIZE CASE/12 

UNITCOST 9.00 

MARKUP 0.30 


RETPRICE 11.70 — 


QONHAND 125 

QONORDER O 

REORDERL 50 

QUANDISC 0.02 

VENDNAME HATFIELD SEED CORP 

VENDADDR 1234 ALLENTOWN ROAD HATFIELD, PA 
VENDZIP 19440 


PROONO 4567890 

PRODESC M-M-M PUPPY CHOW 
UNITSIZE SACK/25LB 

UNITCOST 4.50 

MARKUP 0.30 

RETPRICE 5 85 

QONHAND 100 

QONORDER O 

REORDERL 20 

QUANDISC 0.00 

VENDNAME HOW NOW BROWN CHOW 
VENDADDR 86 LOVETT ST. TAMMYVILLE, DE 
VENDZIP 99685 
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4.11. USING THE SCREEN MENU METHOD TO CREATE THREE KINDS 
OF SELECT DATA PROGRAMS 


Purpose Using the same data file and structure (INVNTORY) you created in 
4.5 and modified in 4.6, you can use the SELECT DATA program 
statement to retrieve your data, using one of three methods: 


Selection methods . Select data, with or without conditions 
a Select data from the workstation 


a Select data of one file from another 


4.12. SELECT DATA WITH CONDITIONS 


Example definition The example in this subsection shows how you use the SELECT 
DATA program statement to issue an inventory reorder. In this @ 
example, you retrieve data records selectively from the file 
INVNTORY based on the IF condition that the field QONHAND 
(quantity on hand) is less than or equal to the field REORDERL 
(reorder level). You then output the reorder records to the printer, 
using the structure INVREORD and the form REORDFM, both 
shown below. 





When you do not specify conditions through either the IF or WHILE 
clauses, all file records are output. 


Example structure As you recall from 4.2, the structure of INVNTORY is: 


STRUCTURE OF INVNTORY 
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Using an output screen form Because you're using a form for your output and you can’t create 
forms in ESCORT, you must create the form either before you enter 
ESCORT or exit from your current session and create it. For this 
example, assume you created the form (REORDFM) before entering 
ESCORT and it looks like this: 


PUPPY WORLD PET SHOP 
1212 Main Blvd. 
Lansdale, Pa. 19191 


* INVENTORY REORDER °° 


Example screen form VENDOR “NAME 


COO0O00000 





Structures and forms Because you're using a form to output your file data, the fields you 
& want to output must appear in the structure in the order you want 
them output in the form. In our INVNTORY structure, the fields do 
not appear in the order you want them output in the form, so you 
must c-eate a new structure. 


Example structure for form So you can visualize how the structure fields parallel the form 
fields, the following structure, named INVREORD, is shown with 
the form fields it parallels: 


STRUCTURE OF INVREORD FORM FIELD DESIGNATION 


Vendor name 
Vendor address 
Vendor zip code 
Stock number 

Unit size 

Cost 

Product description 





Now that your structure and form specifications are complete, 
you're ready to build your program. 


Building the On the PROGRAM COMMANDS menu (screen 4-25), choose 
program number 1, ENTER PROGRAM, and name your program. For this 
example, name it SELDATA and press the XMIT key. Then the 

@ PROGRAM STATEMENTS menu appears. 
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Initiation of SELECT DATA’ = To get the SELECT DATA function, choose number 3 on the 
PROGRAM STATEMENTS menu (screen 4-2). 


This displays the screen containing the format of the basic SELECT 


DATA statement (screen 4-26). (We'll give you more information 
on the basic SELECT DATA statement in 7.11.) 


« Blaitsae * SIRES OLE LAL ANN a assert ta Y 
4-26 a 
SELECT DATA STATEMENT j 





SELECT DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
( <WS (structure-i)> ) 
( <WS (structure-i,formname)>) 


FROM clause, structure names AND formname ARE OPTIONAL PARAMETERS 
file-m 1S NAME OF DATA FILE BEING SELECTED 

file-i IS NAME OF DATA FILE CONTAINING SELECT CRITERIA 

IF WORKSTATION USED AS SELECTION CRITERIA DEVICE, 

THEN KEYIN WS FOR file-i PARAMETER 

KEYIN PARAMETERS 

file-m structure-m 


fite-i structure-i 





formname 





Required parameters Notice that the only required parameter is the fi/e-m specification. 
This names the file you want to retrieve (INVNTORY, for this 
example). 


Structure-name parameter Again, the structure-name parameter is optional, and you need 

only use it when the structure name is different from the first eight 
Structure-name,formname characters of the file name or when you use the structure- 
parameter name,formname parameter to designate a customized output form. 


Parameter keyin For this example, fill in the file-m parameter with the file name 
INVNTORY. You don’t need a structure name because it’s the same 
as the name of the file you're selecting. Your SELECT DATA screen 
now looks like screen 4-27. | 


SCREEN d : 
4-27 SELECT DATA STATEMENT 

SELECT DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
( <WS (structure-i)> ) 
{ <WS (structure-i,formname)>) 

FROM clause, structure names AND formname ARE OPTIONAL PARAMETERS 

file-m 1S NAME OF DATA FILE BEING SELECTED 

file-i IS NAME OF DATA FILE CONTAINING SELECT CRITERIA 

IF WORKSTATION USED AS SELECTION CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i PARAMETER 

KEYIN PARAMETERS: 








file-m QURDRRIN).--______..-____---___---__------ Structure-m 2 lL 
filOe iC. 20 2 o4 a en een eee ON Le ee structure-} 9 | _ 
formname 
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Clause decisions Once your basic SELECT DATA screen is completed, press the 
XMIT key to proceed. The next screen (screen 4-28) lists all the 
clauses applicable to the SELECT DATA statement. 


SCREEN 
4-28 





SELECT NEXT CLAUSE FOR SELECT DATA STATEMENT 





1. USING clause 11. OUTPUT TO PRINTER clause 
2. WORKAREA clause 12. OUTPUT TO WS clause 
3. IF clause 13. CREATING clause 
4. WHILE clause 14. EXTENDING clause 
5. COMPUTING clause 15. UPDATING clause 
6. CLEARING clause 16. EXIT clause 
7. SUBTOTALING clause 17. DISPLAY CURRENT PROGRAM BEING ENTERED 
8. TOTALING clause 18. DIRECT ENTRY OF CLAUSES 
9. PRINT clause 19. CANCEL LAST CLAUSE ENTERED 
10. DISPLAY clause 20. SELECT DATA STATEMENT COMPLETED 
SELECTION _ 
IF clause Because you want to set conditions on the data selecticn, choose 
& number 3, IF clause. 


The screen containing the format for the IF clause appears (screen 
4-29); key in your conditional clause and any clauses to be 
executed if the conditions you specify are satisfied: 


ma SCREEN 
4-29 





iF clause 
IF clause FUNCTION: APPLIES CONDITIONS THAT DETERMINE WHETHER TO PROCESS OR NOT TO 
Screen PROCESS THE GROUP OF CLAUSES THAT FOLLOW. 
FORMAT: 1F <conditions> clauses (ELSE clauses) END 
<FIRSTIME > 
<ENDOFILE > 
KEYIN CONDITIONS AND CLAUSES, INCLUDING ELSE CLAUSES IF APPLICABLE 
1F QONHAND LE REORDERL 
OUTPUT 10 PRINTER INVREORD. REORDFM} 
END 
Using customized Because you want customized data output to the printer, key in the 
output OUTPUT TO PRINTER clause with the necessary structure and form 
names. 
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PRINT clause 


Statement completion 


Program compilation 


Saving the program 


Program display 


Example program 
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If you don’t want customized output and still want a printer listing, 
use the PRINT clause that uses standard system formatting. 


When you complete this screen, press the XMIT key to proceed. 
The SELECT DATA clauses screen is then redisplayed (screen 
4-28). Because you're finished with the SELECT DATA program 
keyin, pick number 20, SELECT DATA STATEMENT COMPLETED. 


When ESCORT receives this statement, it compiles your program 
and displays the PROGRAM COMMANDS menu (screen 4-30). 
Now you can choose what you want to do with your program. 





PROGRAM COMMANDS 
. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 





1 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 
6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 
SELECT COMMAND _ PROGRAM NAME 


Again, as with all programs, you have the option to save your 
program. Because this program can be used over and over again 
for inventory reorders, it would be wise to save it. (We'll give 
information on saving programs in 5.13.) 


To get an idea of what your finished program looks like, choose 
number 4, DISPLAY PROGRAM, on screen 4-30 and key in the 
name of the program you want displayed (SELDATA). Then 
ESCORT displays your sample program: 







SELECT DATA OF INVNTORY 
IF QONHAND LE REORDERL 
OUTPUT TO PRINTER (INVREORD, REORDFM) 
END 
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To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Program execution Then choose number 2, RUN PROGRAM, to execute your program. 


Of the following four records from the previously created file 
INVNTORY, only 1, 2, and 4 meet the selection conditions. 


PRODNO 1357911 PRODNO 5791113 

PRODESC WHITE MICE PRODESC AMAZON PARROT 
UNITSIZE AIRBOX/12 UNITSIZE AIRBOX/1 

UNITCOST 6.00 UNITCOST 125.00 

MARKUP .20 MARKUP 1.00 

RETPRICE 7.20 RETPRICE 250.00 

QONHAND 1 QONHAND 2 

QONORDER O QONORDER O 

REORDERL 1 REORDERL 1 

QUANDISC 0.00 QUANDISC 0.00 

VENDNAME MOUSE HOUSE INC. VENDNAME HOUSE OF BYRDES 
VENDADDR 1234 DEAN DR. WILMINGTON, DE. VENDADDR 1356 CUTTLEBONE WAY BRASILIA, BRAZIL 
VENDZIP 19808 VENDZIP 00000 


PRODNO 9111317 PRODNO 9783457 
PRODESC TROPICAL FISH ASSORTMENT PRODESC PARAKEET TREATS 
UNITSIZE WATERBAG/1 UNITSIZE CASE/24 
-{ UNITCOST 1.00 UNITCOST 14.16 
MARKUP .50 


RETPRICE 21.24 

QONHAND 1 

QONORDER O 

REORDERL 2 

QUANDISC 0.00 

VENDNAME BIRDSBORO BIRD CO. 
VENDAODR 637 GREENE ST. PARA, PA. 
VENDZIP 58972 
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The three forms show the data records from INVNTORY that 
the selection criteria and are output for inventory reorder. 


OOO0O0000 





PUPPY WORLD PET SHOP 
1212 Main Blvd. 
Lansdale, Pa. 19191 


** INVENTORY REORDER °° 
VENDOR NAME MOUSE HOUSE INC. 
VENDOR ADDRESS 1234 DEAN DR. WILMINGTON,DE. ZIP 19808 
STOCK NUMBER 1357911 UNITSIZE AIRBOX/12 cost 6.00 
PRODUCT DESCRIPTION WHITE MICE 


PUPPY WORLD PET SHOP 
1212 Main Bivd. 
Lansdale, Pa. 19191 


* INVENTORY REORDER °° 
VENDOR NAME SOMETHING'S FISHY CO. 
VENDOR ADDRESS 1206 HARBOR HILL DR. WILLOWROCK, SC ZiP 01935 
STOCK NUMBER 9111317 UNITSIZE WATERBAG/1 cost 1.00 
PRODUCT DESCRIPTION TROPICAL FISH ASSORTMENT 


PUPPY WORLD PET SHOP 
1212 Main Blvd. 
Lansdale, Pa. 19191 


* ENVENTORY REORDER * 
VENDOR NAME BIRDSBORO BiRD CO. 
VENDOR ADDRESS 637 GREENE ST. PARA, PA. ZIP 58972 
STOCK NUMBER 9783457 UNETSIZE CASE/24 COST 14.16 
PRODUCT DESCRIPTION PARAKEET TREATS 


4.13. SELECT DATA FROM THE WORKSTATION 


Program objective 


Again using the file and structure created in 4.5 (INVNTORY), this 
SELECT DATA FROM WS example performs a file 
operation. Because the field PRODNO (product number) in the 
structure INVNTORY is the key field, this field is used as your 


prompt field. 


The program you write for this example displays the key field 
prompt from your file. You key in the product number (PRODNO) of 
the record you want selected, and ESCORT gets that record and 


displays it on the workstation. 


meet 


OODONO0C000 


OOODO0O0O000 





inquiry 
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We'll assume you've chosen the ENTER PROGRAM command from 
the PROGRAM COMMANDS menu (screen 4-1) and are now at 
the PROGRAM STATEMENTS menu (screen 4-2). 


Initiation of SELECT DATA’ To get the SELECT DATA function, choose number 3 on the 
PROGRAM STATEMENTS menu (screen 4-2). 


This displays the screen containing the format of the basic SELECT 
DATA statement (screen 4-31). (We'll give more information on the 
basic SELECT DATA statement in 7.11.) 


SCREEN — 
4-31 
SELECT DATA STATEMENT 


SELECT DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
( <WS (structure-i)> ) 
{ <WS (structure-i,formname)>) 

FROM clause, structure-names AND formname ARE OPTIONAL PARAMETERS 

file-m |S NAME OF DATA FILE BEING SELECTED 

file-i 1S NAME OF DATA FILE CONTAINING SELECTION CRITERIA 

IF WORKSTATION USED AS SELECTION CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i PARAMETER 


KEVIN PARAMETERS 





SELECT DATA 


eS statement 


GUE oe = 3 A as et Oe ye etre Chee te ee structure-m 09) 
ADO 2 et tc PA SNS Rg Kath gc pet Ms structure-i 9°) 
formname == se " 
Required parameters Notice that the only required parameter is the fi/e-m specification. 
This names the file you want to retrieve (INVNTORY, for this 
example). 
Structure-name Again, the structure-name parameter is optional. You use it only 
parameter when the structure name is different from the first eight characters ~~_ 


Structure-name,formname of the file name or when you use the structure-name,formname 
parameter parameter to designate a customized output form. 
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Parameter keyin 


SELECT DATA 
statement 


Clause selection 
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For this example, fill in the fi/e-m parameter with the file name 
INVNTORY. You don’t need a structure name because it’s the same 
as the name of the file you’re selecting. Then key in WS for the 
file-i parameter. Your SELECT DATA screen now looks like screen 
4-32. 


SCREEN oe wae emmeneara a es 
4-32 
SELECT DATA STATEMENT 





SELECT DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
( <WS (structure-i)> ) 
( <wS (structure-i,formname)>) 


FROM clause, structure-names AND formname ARE OPTIONAL PARAMETERS 
file-m |S NAME OF DATA FILE BEING SELECTED 

file-i 1S NAME OF DATA FILE CONTAINING SELECT CRITERIA 

1F WORKSTATION USED AS SELECTION CRITERIA DEVICE, THEN 

KEYIN WS FOR file-i PARAMETER 


KEYIN PARAMETERS 


tile-m (QUMQRNR tt eee structure-m oo 
fibes (Ba Saye ee ee ee oes structure-i 9) | 
formname 


Now that your basic SELECT DATA screen is completed, press the 
XMIT key to proceed. The next screen (screen 4-33) lists all the 
clauses applicable to the SELECT DATA statement. 


SCREEN FF... 
4-33 





SELECT NEXT CLAUSE FOR SELECT DATA STATEMENT 


1. USING clause 11. OUTPUT TO PRINTER clause 

2. WORKAREA clause 12. OUTPUT TO WS clause 

3. IF clause 13. CREATING clause 

4. WHILE clause 14. EXTENDING clause 

5. COMPUTING clause 15. UPDATING clause 

6. CLEARING clause 16. EXIT clause 

7. SUBTOTALING clause 17. DISPLAY CURRENT PROGRAM BEING ENTERED 
8. TOTALING clause 18. DIRECT ENTRY OF CLAUSES 

9. PRINT CLAUSE 19. CANCEL LAST CLAUSE ENTERED 

10. DISPLAY clause 20. SELECT DATA STATEMENT COMPLETED 


SELECTION _ 
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Displaying data Because you want to display the data records you select on the 
records workstation, choose number 10, DISPLAY clause. The screen 
containing the format for the DISPLAY clause appears (screen 


4-34). 


SCREEN 
4-34 





DISPLAY clause 
FUNCTION: DISPLAYS ON THE WORKSTATION, USING AUTOMATIC FORMATTING, A DATA 


RECORD; OR SELECTED DATA FIELDS AND LITERAL EXPRESSIONS; OR THE 
SUBTOTALING DATA FIELDS; OR THE TOTALING DATA FIELDS. 


DISPLAY clause FUNCTION: DISPLAY (<structure-name> ) 
(<field-names, ‘‘literal expressions’ >) 
(<SUBTOTALS> ) 
{<TOTALS> ) 


KEYIN ONLY ONE OR NONE OF THE FOLLOWING: 
1. STRUCTURE NAME ENCLOSED IN PARENTHESES ( ) 
2. FIELD NAMES AND LITERAL EXPRESSIONS 
3. THE WORD - SUBTOTALS 
4. THE WORD - TOTALS 


DISPLAY 





Because you want to display the whole record, you don’t need to 
use any of the parameters. Press the XMIT key to continue. 


The SELECT DATA clauses screen reappears (screen 4-33). 
Statement completion Because you're finished keying in your program, pick number 20, 
SELECT DATA STATEMENT COMPLETED. 


Program compilation When ESCORT receives this statement, it compiles your program 
and displays the PROGRAM COMMANDS menu (screen 4-35). 
Now you can choose what you want to do with your program. 


SCREEN 
4-35 





PROGRAM COMMANDS 


1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 
6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 





SELECT COMMAND _ PROGRAM NAME 
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Saving the program 


Displaying the program 


Example program 


Program execution 


Keyed file selection 
prompt 


Keyed file record 
selected 
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Again, as with all programs, you have the option to save your 
program. Because you probably won't use the program again, you 
won't need to save it. 


To get an idea of what your finished program looks like, choose 
number 4, DISPLAY PROGRAM, on screen 4-35. Because you're 
using the system-supplied name, RESIDENT, you don’t need to key 
in a program name, just press the XMIT key. Then ESCORT 
displays your sample program: 


SELECT DATA OF INVNTORY FROM WS AND DISPLAY 





To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Then choose number 2, RUN PROGRAM, on screen 4-35 to 
execute your program. 


When your program is executed, the key field prompt (PRODNO) 
appears on your screen: 


PRODNO 





Key in the product number of the record you want to select (e.g., 
1357911), and ESCORT displays the rest of the record. The record 
for this product number appears: 


PRODNO 1357911 
PRODESC WHITE MICE 
UNITSIZE AIRBOX/12 
UNITCOST 6.88 
MARKUP .28 
RETPRICE 7.26 


QONHAND 1 

QONORDER 0 

REORDERL 1 

QUANDISC 0.00 

VENDNAME MOUSE HOUSE INC. 

VENDADDR 1234 DEAN DR. WILMINGTON,DE. 
VENDZIP 19808 
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Each time you press the XMIT key, the prompt reappears, and you 
key in the product number for the next record you want to see. 


To terminate input, press the FUNCTION and F4 keys. _ 


4.14. SELECT DATA FROM ANOTHER FILE 


Program objective This sample data retrieval program selects data from a file, using 
two other files, and creates a fourth file. 


Files used The program uses four files, three input and one output. It 
produces an itemized sales listing and the total daily sales. 


The example uses these four structures: 


INPUT 
@ Example structures VENDMSTR TRANFILE PARTFILE 


VNUMBER VNUMBER 
VNAME ITEMCODE 
VADRESS NUMITEMS 
VCITYST 


TELEPHON 
BALANCE 
REMARKS 





OUTPUT DLYSALES 


VNUMBER 
ITEMCODE 
PARTDESC 
NUMITEMS 


PRICE 
TOTALPRC 
DATE 





Because this example is longer and involves more clauses than 
previous examples, we won't show the individual screens. Instead, 
we'll list the program and explain it line by line and then show the 


& sample output. 


Example setup ESCORT programs do not have line numbers; however, the sampte 
program is numbered for ease of explanation. 
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Example of selecting As shown in Figure 4-1, the program, line by line: 
from another file 
1. Reads a record from the unkeyed file TRANFILE. Then selects 
a record from the keyed file VENDMSTR, using the value of 
the key field VNUMBER of TRANFILE as the selection criteria. 


Then selects a record from PARTFILE, using the value of the 
ITEMCODE field of TRANFILE as the selection criteria. 


INPUT FILES VENDMSTR TRANFILE PARTFILE WORKSTR* 


| VNUMBER | =| VNUMBER | || ITEMCODE 
VNAME ITEMCODE | | PARTDESC <i 
VADDRESS NUMITEMS | 4] PRICE 
VCITYST =] COST 
TELPHON a 
BALANCE 





PROGRAM The program creating DLYSALES wants the data to be selected from 
VENDMSTR based on the fields in TRANFILE. 


Because VENDMSTR does not have the PARTDESC and PRICE fields, it 
must use PARTFILE, which does. 


SELECT DATA OF VENDMSTR FROM TRANFILE USING PARTFILE 

WORKAREA (WORKSTR) 

(fF FIRSTIME 

COMPUTING STITLE = "‘OATLY SALES LISTING’, DATE=$DATE END 
COMPUTING TOTALPRC = PRICE * NUMITEMS 

TOTALING “‘TOTAL DAILY SALES’* TOTALPRC 

PRINT VNUMBER, VNAME, 1TEMCODE, PARTDESC.NUMITEMS, PRICE, TOTALPRC 
CREATING DLYSALES 

IF ENDOFELE 

PRINT TOTALS 


oiaupeen = aera 


OUTPUT The data from the input file fields combines to form the new data file 
FILE DLYSALES. The fields TOTALPRC and DATE do not exist in the input 

files. TOTALPRC is a work area field in the structure used in the 
WORKAREA clause, and DATE is initialized in the COMPUTING clause 
(line 3) using the system utility field SDATE. 


DLYSALES 


|| VNUMBER | 
ITEMCODE 


i KSTR i 
WORKSTR is not an PARTDESC 


input file. It is simply 
a structure containing 
fields not included in 
the input files but used 
in the program. = 4 





Figure 4-1. Example of Selecting from Another File 
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Because you're only using TOTALPRC as a _ one-time 
calculation for your output, you create a structure (WORKSTR) 
for it. Then you designate the name of the structure in the 
WORKAREA clause. When your calculations are performed, 
ESCORT knows where to find TOTALPRC. 


If this is the first time through the processing cycle, performs 
the clauses on line 4 through END. 


If it’s not the first time through the processing cycle, skips to 
line 5, 


Assigns values to data fields, using two data replacement 
statements: 


= S$TITLE 


Is the system utility field that prints the title ‘DAILY 
SALES LISTING” at the top of your report. 


= DATE 
Is a field in the structure DLYSALES that you assign the 
value of the system utility field, $DATE. This prints the 


current system date whenever you print your report. 


END encloses the clauses to be performed if the FIRSTIME 
clause tests true. 


Calculates the total price of the transaction. 


Contains the literal “TOTAL DAILY SALES” and accumulates a 
grand total for the field TOTALPRC. 


Prints, using automatic formatting, the data fields you list as 
part of your report. 


Creates a new file called DLYSALES, using the fields in the 
DLYSALES structure and the data selected from VENDMSTR, 
TRANFILE, and PARTFILE. 


If it’s the end of the input file (TRANFILE), performs the clause 
on line 10. 


If it’s not the end of the input file, returns to line 1. 
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Example output 


VNUMBER: 12345 
NUMITEMS: 2 


VNUMBER: 56791 
NUMITEMS: 4 


VNUMBER: 15972 
NUMITEMS: 3 


VNUMBER: 15973 
NUMITEMS: 12 





VNUMBER: 12352 
NUMITEMS: 3 


TOTAL DAILY SALES 


OOVOOCOOOOCOOOOCOOOC0OD 
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10. Prints the literal ‘TOTAL DAILY SALES” and the grand total of 
the field TOTALPRC. 


The data shown in the printout is random data that we placed in 
our files. 


Your output for this program will differ, depending on the data you 
key into your original files. The sample program produces the 
following output: 


DATE 81/11/18 TIME 10:04:21 --SYSTEM 80 - ESCORT DATA LISTING-- PAGE 001 


DAILY SALES LISTING 01/23/81 
MARY M'S SPEED SHOP ITEMCODE: A238D1 PARTDESC: MUFFLER 
49.99 TOTALPRC: 


: ELSIE'S GARAGE 
: 28.99 TOTALPRC: 


: B & B AUTO PARTS 
3.99 TOTALPRC: 


: B & B AUTO PARTS 
99 TOTALPRC: 


DAVID J'S AUTO SUPPLY 
PRICE: 5.49 TOTALPRC: 16.47 


256.26 

















UP-8855 Rev. 1 SPERRY UNIVAC O0S/3 4-45 
ESCORT 





4.15. USING THE SCREEN MENU METHOD TO CREATE A DELETE 
DATA PROGRAM 


You use the DELETE DATA statement to remove data records from 
an existing file. The DELETE DATA statement provides you with 
three ways to remove data from your files: 


Deletion methods 1. Inquiry from the workstation 
2. Matching from another file 
3. Based on IF conditions 


The sample programs illustrating these three methods use the file 
structures INVREORD and INVDEL. 


STRUCTURE OF INVREORD STRUCTURE OF INVDEL 


VENDNAME 
Example structures VENDADDR 

VENDZIP 

PRODNO 





UNITSIZE 
UNITCOST 
PRODESC 





4.16. DELETE DATA BY WORKSTATION INQUIRY 


Example definition The first of the three methods of removing data records from your 
file is the workstation inquiry method. The sample program 
instructs ESCORT to provide a prompt field, which in this case is 
your key field PRODNO. You key in the product number that 
identifies the record you want to remove, and ESCORT marks it as 
deleted. 


Initiation of DELETE DATA To get the DELETE DATA function, choose number 4 on the 
PROGRAM STATEMENTS menu (screen 4-2). 
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This displays the screen containing the format for the DELETE 
DATA program statement (screen 4-36). (We'll give information on 
the DELETE DATA program statement in 7.14.) 


SCREEN 
4-36 





DELETE DATA STATEMENT 

DELETE DATA OF file-m (structure-m) (FROM <file-i(structure-i)> } 
( <wsS (structure-i)> ) 
{ <wS (structure-i,formname)-) 





<IF conditions a 
structure names AND formname ARE OPTIONAL PARAMETERS 


DELETE DATA 





statement MUST SELECT EITHER THE FROM OR IF CLAUSE OPTION 
IF WORKSTATION USED IN FROM CLAUSE, THEN KEYIN WS FOR file-i PARAMETER 
KEYIN PARAMETERS AND iF CLAUSE WHEN USED 
Oise sly ot hg ee ee a Ah te I Ah structure-m 
Pica tt 228 he ne. Bi ac ak ee als ts structure-i 909 
formmame = 
Parameter keyin Notice that there are several parameter choices. For the 


workstation inquiry method, use the file-m and FROM WS 
parameters. Fill in the file-m parameter with your file name 
INVREORD and, because you're using the FROM WS parameter, 
key in WS in the file-i space. Your screen now looks like screen 
4-37. | 


SCREEN 
4-37 





DELETE DATA STATEMENT 
DELETE DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
{ <wWS (structure-i)> ) 
( <WS (structure-i,formname)—) 


<iF conditions 
structure names AND formname ARE OPTIONAL PARAMETERS 
MUST SELECT EITHER THE FROM OR IF CLAUSE OPTION 
IF WORKSTATION USED IN FROM CLAUSE, THEN KEYIN WS FOR file-i PARAMETER 


KEYIN PARAMETERS AND iF CLAUSE WHEN USED 


DELETE DATA 
parameters 


fite-m [ERETZTTJ =i ‘a‘#$C.$NN" NNN structure-m ool 
tite ch ERY eo oe eh ee a structure-i 9) 
formname 
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Statement completion 


Program display 


Example program 


Program execution 


Program results 


Keyed file deletion 
prompt 


Record number to 
be deleted 
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When you complete your DELETE DATA statement, press the XMIT 
key. Because there are no additional clauses you can use with the 
DELETE DATA statement, ESCORT compiles your program, and the 
PROGRAM COMMANDS menu (screen 4-35) reappears. 


To get an idea of what your finished program looks like, choose 
number 4, DISPLAY PROGRAM. Then ESCORT displays your 
sample DELETE DATA program: 


DELETE DATA OF INVREORD FROM WS 





To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Then choose number 2, RUN PROGRAM, to execute your program. 
When your program executes, the records whose keys you entered 


at the workstation prompt are marked for deletion from the 
INVREORD file. 







PRODNO 


To mark the record for deletion, key in the product number of the 
record you want removed in the space allotted. 


PRODNO BREYUT#3 
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4.17. DELETE DATA BY FILE MATCHING 


When you want to use the DELETE DATA statement for file 
Creating transactional matching, you create a transactional file much like the one you 
files created in the second CHANGE DATA example: CHANGE DATA by 
replacing (4.10). Then you enter data into this file by using an 
ENTER DATA program (3.5). 


Example definition The structure for this transactional file is INVDEL (4.15). ESCORT 
matches a file record from INVDEL to a file record from INVREORD, 
using the key field PRODNO. When the record is found, ESCORT 
marks it as deleted. This process continues until ESCORT reaches 
the end of the input file (INVDEL), and then the program 
terminates. 


Parameter keyin For the file matching method of data deletion, you use the file-m 
parameter and the FROM file-i parameter (screen 4-38). Fill in the 
file-m parameter with the name of the file from which you want 
the records deleted (INVREORD), and fill in the fi/e-/ parameter 
with the name of the transactional file (INVDEL). 


ML SCREEN Fie 
4-38 


DELETE DATA OF file-m (structure-m) (FROM <file-i(structure-i)}> ) 
( <wsS (structure-i)> ) 
( <wS (structure-i, formname)>) 








DELETE DATA STATEMENT 


DELETE DATA 





statement <IF conditions > 
structure names AND formname ARE OPTIONAL PARAMETERS 
MUST SELECT ETHER THE FROM OR !F CLAUSE OPTION 
1F WORKSTATION USED IN FROM CLAUSE, THEN KEYIN WS FOR file-i PARAMETER 
KEYEN PARAMETERS AND IF CLAUSE WHEN USED 
file-m (EEL et ek ot ele wae ee ee eee Structure-m 
tite-: [EY structure-i 9 
formname «= - 
IF \ 
Statement completion When you complete your DELETE DATA statement, press the XMIT 
key. Because there are no additional clauses you can use with the 
Program compilation DELETE DATA statement, ESCORT compiles your program, and the 


PROGRAM COMMANDS menu (screen 4-35) appears. 
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Program display 


Example program 


Program execution 


Program action 
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To get an idea of what your program looks like, choose number 4, 
DISPLAY PROGRAM, and key in your program name. Then, 
ESCORT displays your program. 


DELETE DATA OF INVREORD FROM INVDEL 





To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Then choose number 2, RUN PROGRAM, on the PROGRAM 
COMMANDS menu to execute your program. 


When your program is executed, the records of INVREORD to be 


deleted are selected and marked as deleted, using the matching 
key PRODNO from the file INVDEL. 


Records from INVREORD: Records from INVDEL: 






















VENDNAME WCM PET EMPORIUM PRODNO 2468012 


VENDADDR 1876 CHESTNUT LANE, EAGLEVILLE, P 
VENDZIP 19876 

PRODNO 2468012 

UNITSIZE CASE/12 

UNITCOST 12.00 

PRODESC PERKY PUPPY PUFFS 


PRODNO 4567890 


PRODNO 9567890 









VENDNAME HOW NOW BROWN CHOW 
VENDADDR 86 LOVETT ST. TAMMYVILLE, DE 
VENDZIP 99685 

PRODNO 4567890 

UNITSIZE SACK/25LB. 
UNITCOST 4.20 

PRODESC M-M-M PUPPY CHOW 










VENDNAME MOUSE HOUSE INC. 
VENDADDR 1234 DEAN DR. WILMINGTON, DE 
VENDZIP 19808 

PRODNO 5791114 

UNITSIZE CASE/24 

UNITCOST 24.00 

PRODESC MOUSIE CHEESE FOOD 









VENDNAME DAVID J'S PET SUPPLY 
VENDADDR 1206 HONEY LANE GERMANTOWN, PA 
VENDZIP 19801 

PRODNO 9567890 

UNITSIZE CASE/24 

UNITCOST 72.00 

PRODESC TICK-AWAY TICK COLLARS 





UP-8855 Rev. 1 SPERRY UNIVAC 08/3 4-50 
ESCORT 





Program results As a result of your program’s execution, records 1, 2, and 4 are ~~ 
marked as deleted because their product numbers (PRODNO) 
match. Record 3, for Mouse House Inc., is not deleted because 
there is not a corresponding record in INVDEL that specifies that it 
should be deleted. 


4.18. DELETE DATA BASED ON IF CONDITIONS 


Removing data records based on IF conditions means that you 


Purpose want to ensure that certain criteria are met before the deletion can 
occur. 
Example definition For this example, suppose one of your vendors goes out of 


business and you want to remove all inventory items supplied by 
that vendor from your INVNTORY master file. To do this, you use 
the DELETE DATA program statement and its corresponding IF 
clause (screen 4-39). 





Parameter keyin For the IF conditional method of data deletion, simply use the file- 
m parameter and the /F conditions parameter. Fill in the file-m 
parameter with the name of the file where you want the records 
deleted (INVNTORY). Then, fill in the /F parameter with the 
conditional clause of your choice. For this example, assume the 
vendor's name is the Birdsboro Bird Co. Your DELETE DATA screen 
for this example now looks like this: 


SCREEN 
4-39 





DELETE DATA STATEMENT 
DELETE DATA OF file-m (structure-m) (FROM <file-i(structure-i)> ) 
( <WS (structure-i)> ) 
( <WS (structure-i,formname)—) 
<IF conditions Z 
structure names AND formname ARE OPTIONAL PARAMETERS 
MUST SELECT EITHER THE FROM OR IF CLAUSE OPTION 
IF WORKSTATION USED IN FROM CLAUSE, THEN KEYIN WS FOR file-i PARAMETER 
KEYIN PARAMETERS AND JF CLAUSE WHEN USED 


fite-m TERTRE ee structure-m 


file-i structure-i 


DELETE DATA 
statement 


formname 


[Pa VENDNAME CONTAINS ‘‘BIRDSBORO BIRD CO.'' 
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Statement completion 


Program compilation 


Program display 


Example program 


Program execution 


Program results 
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When you complete your DELETE DATA statement, press the XMIT 
key. Because there are no additional clauses you can use with the 
DELETE DATA statement, ESCORT compiles your program, and the 
PROGRAM COMMANDS menu appears (screen 4-35). 


To get an idea of what your program looks like, choose number 4, 
DISPLAY PROGRAM. Then, ESCORT displays your program: 


DELETE DATA OF INVNTORY 


(F VENDNAME CONTAINS ‘‘BIRDSBORO BIRD CO.'' 





To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Then choose number 2, RUN PROGRAM, on the PROGRAM 
COMMANDS menu to execute your program. 


The result of your program’s execution is that every record 
containing the words ‘‘Birdsboro Bird Co."’ in the VENDNAME field 
is marked for deletion. 
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4.19. USING THE SCREEN MENU METHOD TO CREATE TWO KINDS OF SORT 
DATA PROGRAMS 


Sort key definition 


Sort key usage 


Nonindexed files 


SORT DATA statement 
usage 


Variations of the 
SORT DATA statement 


The file structures for the previous examples in this section all 
contain at least one sort key. This means that they are keyed files 
and, when you reference them, the fields designated as key fields 
are output. When you select or change these records, you use 
these sort keys to determine which records you want to access. 
(We'll explain sort keys in 6.7.) 


When you don't designate sort keys in a file, you have a 
nonindexed, sequential file. This means the records are written 
into your file in the exact order you enter them. This is not a very 
efficient method for a file because your records usually cannot be 
output in any meaningful order. 


The SORT DATA program statement lets you take a nonindexed, 
sequential file and create a new, sorted file that you can use to 
output reports or data listings. 

There are two variations of the SORT DATA program statement: 


= SORT DATA by designating field names 


= SORT DATA by matching structure field 
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4.20. SORT DATA BY DESIGNATING FIELD NAMES 


Example definition This sample SORT DATA program uses the structure INVNTORY 
minus the sort key (PRODNO). It then creates a new file called 
MAILIST, which contains an alphabetized mailing list of suppliers. 
Because the list is alphabetized, the sample program uses the field 
VENDNAME as the sort field. 


STRUCTURE OF INVNTORY STRUCTURE OF MAILIST 


PRODNO 
PRODESC 
UNITSIZE 
Example structures UNITCOST 
MARKUP 
RETPRICE 
QONHAND 


QONORDER 
REORDERL 
QUANDISC 


@ VENDNAME 





We'll assume you've chosen the ENTER PROGRAM command from 
the PROGRAM COMMANDS menu (screen 4-1) and are now at 
the PROGRAM STATEMENTS menu (screen 4-2). 


Initiation of SORT DATA —s To: get the SORT DATA function, choose number 5 on the 
PROGRAM STATEMENTS menu (screen 4-2). 
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This displays screen 4-40, which contains the format of the SORT 
DATA program statement. (We'll give more information on the 





SORT DATA statement in 7.13.) { 
SCREEN We 
4-40 
SORT DATA STATEMENT 





SORT DATA OF file-m (structure-m) (BY fieldl,....., field6) 
CREATING file-s (structure-s) 


BY clause AND structure-names ARE OPTIONAL PARAMETERS 

A MAXIMUM OF SIX FIELD NAMES MAY BE USED AND THEIR ORDER OF 
APPEARANCE DETERMINES THE HIERARCHY FOR THE SORT 

file-m 1S NAME:OF DATA FILE TO BE SORTED 

file-s 1S NAME OF DATA FILE CREATED FROM SORT 


KEVIN PARAMETERS 


SORT DATA statement 


file-m structure-m 


file-s structure-s 


fieldl 
field2 
field3 
field4 
fieids 
field6 





Required parameters Notice that the only required parameters are file-m and the 
CREATING clause. The file-m parameter names the file containing 
the data to be sorted. The CREATING clause names the new sorted 
file. The structure-m and structure-s parameters are optional. You 
use them only if the structure name is different from the first eight << 
characters of the file name or you want to use a different structure 
to output specific fields of a file. The BY clause, which lets you 
designate the fields to sort your data, is optional. 


Parameter keyin For this example, fill in the file-m parameter with the input file 
name INVNTORY. Also fill in the BY field7 parameter with the field << 
name VENDNAME, because you want to sort your list 
alphabetically. Then key in the fi/e-s parameter with the output file 
name MAILIST. Your SORT DATA screen now looks like screen 
4-41. 
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SCREEN 
4-41 


SORT DATA OF file-m (structure-m) (BY fieldl,....., field6é) 
CREATING file-s (structure-s) 


BY clause AND structure-names ARE OPTIONAL PARAMETERS 

A MAXIMUM OF SIX FIELD NAMES MAY BE USED AND THEIR ORDER OF 
APPEARANCE DETERMINES THE HIERARCHY FOR THE SORT 

file-m |S NAME OF DATA FILE TO BE SORTED 

file-s 1S NAME OF DATA FILE CREATED FROM SORT 


KEVIN PARAMETERS 


file-m structure-m 


fite-s DEMIS =e structure-s 
field) EEEIEE 


field2 


field3 


field4 


field5 


field6 








SORT DATA STATEMENT 


SORT DATA statement 





Statement completion When you complete your SORT DATA statement, press the XMIT 
key. Because there are no additional clauses you can use with the 

Program compilation SORT DATA statement, ESCORT compiles your program, and the 
PROGRAM COMMANDS menu (screen 4-2) appears. 


Program display To get an idea of what your finished program looks like, select 
number 4, DISPLAY PROGRAM, and key in your program name. 
Then, ESCORT displays your sample SORT DATA program: 






SORT DATA OF INVNTORY BY VENDNAME 
CREATING MAILIST 





Example program 


To get back to the PROGRAM COMMANDS menu, press the XMIT 
key. 


Program execution Then choose number 2, RUN PROGRAM, on the PROGRAM 
COMMANDS menu to execute your program. 
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Program results 


Printing the file 
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The result of your program’s execution 


4-56 


is that the fields 


VENDNAME, VENDADDR, and VENDZIP of the unordered file 
INVNTORY are written into the MAILIST file in alphabetical order. 


The records of MAILIST are: 












VENDNAME:BIRDSBORO BIRD CO. 
VENDADDR:637 GREENE ST. PARA,PA. 
VENDZIP:58972 





VENDNAME:HATFIELD SEED CORP. 


VENDZIP:19440 







VENDNAME:HOUSE OF BYRDES 


VENDZIP:00000 






VENDNAME:HOW NOW BROWN CHOW 
VENDADDR:86 LOVETT ST. TAMMYVILLE,DE. 
VENDZIP:99685 


VENDADDR:1234 ALLENTOWN ROAD HATFIELD,PA. 


VENDADOR:1356 CUTTLEBONE WAY BRASILIA,BRAZIL 


Notice you can't print your new sorted data file by using the SORT 
DATA program statement. This is because the PRINT and OUTPUT 
TO PRINTER clauses can't be used with this statement. You can, 
however, print your new file by using a SELECT DATA program 


(SELECT DATA OF MAILIST AND PRINT). 


——— 


~~ 














UP-8855 Rev. 1 SPERRY UNIVAC OS/3 4-57 
ESCORT 


A 





4.21. SORT DATA BY MATCHING STRUCTURE FIELD 


Another way to use the SORT DATA program statement is to 


designate a field as matching sorted (MS) in the new structure <—_— 


designated for your sorted file. 


Example definition When you specify the structure (MAILIST), you pick the field you 
want to sort by (VENDNAME) and, in the KEYS portion of your 
ENTER STRUCTURE screen (screen 6-1), key in MS (matching 


sorted). ~— 


Your structure is: 


Example structure STRUCTURE OF MAILIST 


| VENDNAME a= 
VENDADDR 


VENDZIP 





Example program Then you can use the following program: 


SORT DATA OF ENVNTORY CREATING MAILIST — 





ESCORT action ESCORT creates your sorted MAILIST file by using the key you << 


designated (VENDNAME), and your output is the same as with the 
previous program (4.20). 


The next subsection shows how you can use the direct entry 
method to enter your program more quickly. 
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4.22. PROGRAM MODE - THE DIRECT ENTRY METHOD 





Direct Entry of Program Statements 


Screen format With the direct entry method, you have no statement or clause 
formats, only a blank screen, onto which you type your program 
statements. 

How to access When you want to use the direct entry method, you begin your 


ESCORT session the same as you do for the screen menu method 
(4.2). When the PROGRAM COMMANDS menu (screen 4-1) is 
displayed, you choose the ENTER PROGRAM command and key in 
a program name. Then the PROGRAM STATEMENTS menu (screen 
4-42) is displayed: 


SCREEN fo 
4-42 


PROGRAM STATEMENTS 
. ENTER DATA 
. CHANGE DATA 
. SELECT DATA 
. DELETE DATA 
SORT DATA 
. DIRECT ENTRY OF PROGRAM STATEMENT - FREE FORMAT 
. HELP - EXPLANATION OF STATEMENT FORMAT CONVENTIONS 


SELECTION 





er ee 





Choosing direct entry You get the direct entry method by choosing number 6, DIRECT 
of statements ENTRY OF PROGRAM STATEMENT, from this screen. 


Then an empty screen appears, and you key in a program. 


Program length The type and length of the program are your choice. 


Screen 4-43 shows an example of the direct entry method. 


SCREEN § 
4-43 


ENTER DATA FROM WS y 
CREATING DATAFLE 
OUTPUT TO PRINTER (strname,. formname) 





Direct entry example 
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Note that each program statement or clause need not appear on a 
new line; however, it makes it easier to keep track of where you 
are in the program during keyin. 


Direct Entry of Clauses 


When you use the screen menu method of entering your program, 
you also have the option to use DIRECT ENTRY OF CLAUSES. With 
this method, you use the screen menu formats to complete the 
program statement parameters and when you get to the clause 
selection screen for that program statement type, choose the 
appropriate number to enter the clauses directly. Because only the 
ENTER, CHANGE, and SELECT program statements have additional 
clauses you can use, there is no DIRECT ENTRY OF CLAUSES for 
the SORT or DELETE program statements. When you choose direct 
entry of clauses, a blank screen appears, and you key in the 
clauses you want to use. You are limited to 10 lines per screen. 


To terminate, press the XMIT key and when a blank screen 
appears, press the FUNCTION and F4 keys. 

















SPECIFICS OF PROGRAM MODE 
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5. ESCORT Commands 


5.1. COMMAND SELECTION 


Use 


Command selection 


Command menu 


Example use: programs 





Before you can enter or access a program, structure, job, or data 
file password, you must first use an ESCORT command. 


Once you choose program mode (see Section 4), the command 
selection menu (screen 5-1) is displayed: 


SCREEN §& 
5-1 


verses SELECT ONE OF THE FOLLOWING FUNCTIONS ****"* 


TERMINATE CURRENT ESCORT SESSION 
TUTORIAL MODE OF OPERATION 
STRUCTURE COMMANDS 

PROGRAM COMMANDS 

JOB COMMANDS 

PASSWORD COMMANDS 


SELECTION _ 





Aner wre 


Select the command category you want by keying in the 
appropriate number and pressing the XMIT key. 


This displays a menu listing all the commands in the category you 
choose. For example, suppose you want to enter a program. Key in 
4, and the PROGRAM COMMANDS menu (screen 5-2) appears: 


SCREEN 
5-2 





PROGRAM COMMANDS 


1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 

2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 

3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 

5. PRINT PROGRAM 11. HELP - EXPLANATION OF ABOVE COMMANDS 
6. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 


SELECT COMMAND _ PROGRAM NAME 
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ENTER PROGRAM Then choose 1, ENTER PROGRAM, and enter the program name. @ 


command 
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Note that when you choose the ENTER command (ENTER 
PROGRAM, 
PASSWORDS), you're choosing to initially key in a program, 
structure, job, or data file passwords. When you choose any of the 
other commands (DISPLAY, CHANGE, etc), you're just manipulating 
an existing program, structure, job or password. 


ENTER STRUCTURE, ENTER JOB, ENTER 


When you choose ENTER PROGRAM, screen 5-3 appears: 





SCREEN 
5-3 


. ENTER DATA 

. CHANGE DATA 

. SELECT DATA 

. DELETE DATA 

SORT DATA 

. DIRECT ENTRY OF PROGRAM STATEMENTS - FREE FORMAT 

. HELP - EXPLANATION OF STATEMENT FORMAT CONVENTIONS 


SELECTION _ 


NM OOF WHR > 





PROGRAM STATEMENTS 


Program statement Pick the program statement you want to use. You then proceed 


choice through the sequence of screens you need to get the results you 
want. (We'll give more information on program statements in 


Section 7.) 





Other command types When you choose another type of command (structure, job, or <i 
passwords), the process is the same as in the preceding example. 


Additional commands The only three commands not related to a type are HELP, 
TUTORIAL, and TERMINATE. These commands are also selected by 


menu choices. 


On screen 5-1, 


the TUTORIAL command is choice 2, and 


TERMINATE is choice 1. The HELP command is available as a 
selection on many of the ESCORT menus. <_ 


5.2. TERMS YOU SHOULD KNOW 


Before you proceed with this section, familiarize yourself with the 
following terms, which appear in command descriptions. 


RESIDENT program and job 


RESIDENT Program or Job 


When you enter or change an unnamed program or job, 


ESCORT assigns the default name RESIDENT to it. There can 
be only one RESIDENT program or job per ESCORT session. 





When you enter another one, you lose the original one 
(overlay), and the one you enter becomes RESIDENT. 
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5 Session File 


This file contains everything (programs, structures, jobs) you 
enter or change during an ESCORT session (your current 
session). 


= Library 


The term /J/ibrary refers to the specific ESCORT library 
designated to save your programs, structures, and jobs. 


There are four types of libraries where different types of ESCORT 
data are stored: 


= SCS - for source programs 
= SCO - for object programs 
#  ESCJ - for jobs 

# ESFD - for structures 


You will never see these types displayed when you're using 
ESCORT; however, if you use the interactive services FSTAT 
command, these types are listed as ESCORT files. 


In addition to these four library types, there exists an ESAF type. 
ESAF is a file created as part of ESCO when your object programs 
use the automatic formatting PRINT or DISPLAY clauses. 


Whenever you copy, rename, or delete any of these object 
programs, you must also copy, rename, or delete the ESAF file. You 
do this outside of ESCORT using interactive services. You will see 
the ESAF name displayed when you use the DISPLAY PROGRAM 
NAMES command. 
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ESCORT 
PROGRAM 
5.3. PROGRAM COMMANDS 
Program makeup Programs, as you remember, are comprised of an ESCORT program 


statement and its related clauses and are the means for solving 
your business problems. Before you can enter or access a program, 
you must use an ESCORT command. 


Program commands menu The program commands appear on the following menu (screen 


5-4): 
SCREEN FF 
5-4 


1. ENTER PROGRAM 7. REMOVE PROGRAM FROM WORKFILE 
2. RUN PROGRAM 8. REMOVE PROGRAM FROM LIBRARY 
3. CHANGE PROGRAM 9. DISPLAY PROGRAM NAMES 

4. DISPLAY PROGRAM 10. PRINT PROGRAM NAMES 
5 
6 





PROGRAM COMMANDS 


. PRENT PROGRAM 11. HELP - EXPLANATION OF ASOVE COMMANDS 
. SAVE PROGRAM 12. TERMINATE PROGRAM COMMAND SELECTION 





- 
SELECT COMMAND __ PROGRAM NAME . 


Command selection Key in the number of the command you want and the program 
name and press the XMIT key. We'll explain how to use program 
commands in 5.4 through 5.13. 


5.4. HOW TO CHANGE YOUR PROGRAM (CHANGE PROGRAM COMMAND) 


Purpose Use this command to change a named program stored on your 
session file or the ESCORT library or to change the RESIDENT 
program. 

Named programs When you name the program you want to change, ESCORT: 


1. Gets the program from your session file or the ESCORT library 
2. Lets you make your changes 
3. Puts a copy of the changed program into your session file 


NOTE: 


The changes are made only to the session file copy of your 
program. To make the changes permanent, you must re-save the 
program under the same name. 


Unnamed programs When you don’t name the program you want to change, you make 
the changes on the RESIDENT program. 
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5.5. HOW TO DISPLAY A PROGRAM ON THE WORKSTATION 
(DISPLAY PROGRAM COMMAND) 


Purpose 


Named programs 


Unnamed programs 


Use this command to instruct ESCORT to display a program stored 
on your session file or the ESCORT library on the workstation. 


When you name the program you want to display, ESCORT: 
1. Gets the program from your session file or the ESCORT library 
2. Displays your program 


When you don’t name your program, ESCORT displays the 
RESIDENT program. 


5.6. HOW TO DISPLAY A LISTING OF PROGRAM NAMES 
(DISPLAY PROGRAM NAMES COMMAND) 


Purpose 


ESAF 


Use this command to display, on the workstation, a list of all 
source and object program names contained in both your session 
file and the ESCORT library. 


When you use the DISPLAY PROGRAM NAMES command, you'll 
notice the additional name ESAF. This is a file created as part of 
the object files (ESCO) when your programs use the automatic 
formatting PRINT or DISPLAY clauses. For more on ESAF, see 5.2. 


5.7. HOW TO ENTER A PROGRAM (ENTER PROGRAM COMMAND) 


Purpose 


Named programs 


Unnamed programs 


You use this command to enter a program statement from the 
workstation. 


When you name your program, the program statement is saved in 
the current session file under that name, and you can access it 
until you terminate your session. 


When you don't name your program, ESCORT assigns a default 
name of RESIDENT to your program, and it remains the RESIDENT 
program until you enter another nameless program that overwrites 
it. 





<< 
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5.8. HOW TO PRINT A PROGRAM (PRINT PROGRAM COMMAND) 


Purpose 


Named programs 


Unnamed programs 


Use this command to print a program stored on your session file or 
the ESCORT library. 


When you name the program you want to print, ESCORT: 


1. Gets the program from your session file or the ESCORT library 


2. Prints your program 


When you don’t name the program you want to print, ESCORT 
prints the RESIDENT program. 


5.9. HOW TO PRINT A LISTING OF PROGRAM NAMES 
(PRINT PROGRAM NAMES COMMAND) 


Purpose 


Use this command to print, on the printer, a list of all source and 
object program names contained in both the ESCORT library and 
your session file. 


5.10. HOW TO REMOVE A PROGRAM FROM THE SESSION FILE 
(REMOVE PROGRAM FROM WORKFILE COMMAND) 


Purpose 


Action 


Program removed 
from workfile 
screen 






You use this command to instruct ESCORT to remove the program 
you name from your session file. 


When you specify this command, ESCORT: 


1. Removes both the source language and object programs from 
the session file. 


2. Displays a screen (screen 5-5) confirming that the program 
has been removed from the session file. 


; SCREEN 
5-5 





PROGRAM REMOVED FROM WORKFILE 


DEPRESS TRANSMIT TO RETURN TO PROGRAM COMMANDS _ 
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5.11. HOW TO REMOVE A PROGRAM FROM THE ESCORT LIBRARY 
(REMOVE PROGRAM FROM LIBRARY COMMAND) 


Purpose You use this command to instruct ESCORT to remove the program 
you name from the ESCORT library. 


Action When you choose this command, ESCORT: 


1. Removes from the ESCORT library the source language 
and/or object program (whatever was previously saved). 


2. Displays a screen (screen 5-6) confirming that the program 
has been removed from the ESCORT library. 


SCREEN F 
5-6 ff 






Program removed 
from library 
screen 


PROGRAM REMOVED FROM LIBRARY 


DEPRESS TRANSMIT TO RETURN TO PROGRAM COMMANDS 


5.12. HOW TO EXECUTE YOUR PROGRAM (RUN PROGRAM COMMAND) 


Purpose You use this command to execute the RESIDENT program or one 
stored on your session file or the ESCORT library. 


Named programs When you name the program you want to run, ESCORT: 
1. Gets the program from your session file or the ESCORT library 
2. Executes your program 


Unnamed programs When you don’t name your program, ESCORT executes the 
RESIDENT program. 
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5.13. HOW TO SAVE YOUR PROGRAMS (SAVE PROGRAM COMMAND) 


Purpose 


Library types 


Named programs 





You use this command to save your program statements in the 
ESCORT library. ESCORT programs appear in the library under the 
types: 


a ESCS - for source programs 
w ESCO - for object programs 


= ESAF - an addition of ESCO used when your object programs 
contain automatic formatting clauses (PRINT and DISPLAY) 


For an explanation of library types, see 5.2. 


When you use the SAVE PROGRAM command, you can save the 
source program, the object program, or both. 


The source program is the program you key in before it is compiled; 
the object program is the compiled program. 


If you named the program you want to save on the PROGRAM 
COMMANDS menu (screen 5-4), ESCORT: 


1. Displays screen 5-7, asking what you want to save. (The 


program name you specified on screen 5-4 appears after the 
SAVE PROGRAM heading.) 


SCREEN 
5-7 





SAVE PROGRAM 


. SOURCE PROGRAM 
. OBJECT PROGRAM 
. BOTH SOURCE AND OBJECT PROGRAM 
. NONE OF THE ABOVE - CANCEL COMMAND 
SELECTION _ 
IF YOU WANT TO SAVE THIS PROGRAM UNDER ANOTHER NAME 
THEN KEYIN THE NEW PROGRAM NAME BELOW 
OTHERWISE DEPRESS TRANSMIT AND THE PROGRAM WILL BE 
SAVED UNDER THE PROGRAM NAME DISPLAYED ABOVE 


NEW PROGRAM NAME 


ke wne 
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2. Gets a copy of that program from your session file 


3. Puts it into the ESCORT library file under its own name or a 
new one you designate in the space provided 


NOTE: 


Even though you’ve saved your program, a copy remains on your 
session file until you terminate your session. 


When you don’t name your program in the ENTER PROGRAM 
command but use the system-specified name, RESIDENT, your 
screen heading says SAVE PROGRAM RESIDENT. 


Because you can’t save a program under the name RESIDENT, you 
must rename it in the space allotted for NEW PROGRAM NAME. 
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5.14. STRUCTURE COMMANDS 


Structure makeup 


STRUCTURE COMMANDS 
menu 


Command selection 





Structures consist of structure statements that tell ESCORT what 
your file records look like. Structures are described in detail in 
Section 6. Before you can build or access a structure, you must 
use one of the structure commands. 


The structure commands appear on the following menu (screen 
5-8): 


Ba sceENN 
a 5-8 





STRUCTURE COMMANDS 
. ENTER STRUCTURE 7. REMOVE STRUCTURE 
. CHANGE STRUCTURE 8. INSERT INTO STRUCTURE 
. SAVE STRUCTURE 9. PRINT STRUCTURE NAMES 
. DISPLAY STRUCTURE 10. HELP - EXPLANATION OF COMMANDS 
. DISPLAY STRUCTURE NAMES 11. HELP - EXPLANATION OF STRUCTURES 
- PRINT STRUCTURE 12. TERMINATE STRUCTURE PROCESSOR 


Aor wn a 


SELECT COMMAND __ STRUCTURE NAME 


Key in the number of the command you want and the structure 
name and press the XMIT key. 


We'll explain how to use structure commands in 5.15 through 
b.20. 


5.15. HOW TO CHANGE A STRUCTURE (CHANGE STRUCTURE COMMAND) 


Purpose 


Action 


Use this command to change a structure stored on your session 
file or the ESCORT library. 


When you specify this command, ESCORT: 


1. Gets the structure from your session file or the ESCORT 
library 


2. Lets you make your changes 
3. Puts a copy of the changed structure into your session file 
NOTE: 


The changed structure exists only in your session file. To make the 
changes permanent, you must resave the structure under the same 
name. 
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When your structure exists on both the session file and the 
ESCORT library, the session file copy is the one that’s changed <_ 
when using this command. 


5.16. HOW TO DISPLAY A STRUCTURE ON THE WORKSTATION 
(DISPLAY STRUCTURE COMMAND) 


Purpose You use this command to display a structure from your session file ! 
or the ESCORT library on the workstation. 
Action When you specify this command, ESCORT: 


1. Gets the structure from your session file or the ESCORT 
library 


2. Displays the structure (screen 5-9): 


@ Bee SCREEN FR rrr 
: : 5-9 


. DISPLAY STRUCTURE MAILIST 





TOTAL SIZE: 0078 
LENGTH/ EDIT REPEAT 
FIELDNAME TYPE KEYS CODES COUNT POSITION 


NAME 25A 
ADDRESS 


0001-0025 
0026-0050 


CITY 
STATE 
zIP 
MAILCODE 


0051-0065 
0066-0067 
0068-0072 
0073-0078 
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5.17. HOW TO DISPLAY A LISTING OF STRUCTURE NAMES 
(DISPLAY STRUCTURE NAMES COMMAND) 


Purpose You use this command to display, on the workstation, a list of all 
structure names contained in both your session file and the 
ESCORT library. 


5.18. HOW TO BUILD A STRUCTURE (ENTER STRUCTURE COMMAND) 
Purpose You use this command to enter a structure from the workstation. 


When this command is executed, a screen appears (screen 5-10) 
that guides you in building your structure. 


Mm SCREEN Fe 
* eee) 


LENGTH/ eoIT REPEAT START 
FIELDNAME CODES COUNT POSITION 





ENTER STRUCTURE  — tt —— 
screen  ———‘“‘iOCi~i~si«S re pee a 


Action The structure is saved in the current session file under the name 
you assign, and you can access it until you terminate your session. 
To permanently save a structure, use the SAVE STRUCTURE 
command. 
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5.19. HOW TO INSERT STATEMENTS INTO A STRUCTURE 
(INSERT INTO STRUCTURE COMMAND) 


Purpose You use this command to instruct ESCORT to insert new structure 
statements between existing statements of a structure. 


Action When you specify this command, ESCORT: 


1. Gets the structure from your session file or the ESCORT 
library. 


2. Displays a screen (screen 5-11) on which you indicate where 
the new statements are to be inserted (before which line). 


m scREN 
oo eae oe 





BEFORE WHICH LINE WOULD YOU LiKE TO INSERT STATEMENTS? 


Identify 
S statement line 
screen 


ENTER LINE NUMBER 


NOTE: WHEN INSERTING, EITHER A BLANK LINE OR A FULL SCREEN WILL TERMINATE 
THE INSERTION PROCESS. 





3. Displays a screen (screen 5-12) on which you enter your new 
structure statements. 
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ESCORT 
STRUCTURE 
scREN —————" 
5 12 oo 
Insert into LENGTH/ EDIT REPEAT START 
structure FIELDNAME TYPE KEYS CODES COUNT POSITION 
sereen ————s—si eee nee =e Shhs as ett 








NOTE: BLANK LINE OR FULL SCREEN TERMINATES THE INSERT INTO STRUCTURE FUNCTION. . 


4. Puts a copy of the revised structure into your session file. 


NOTES: 


1. The line number you enter cannot be zero or greater than the 
number of lines already in the structure. 


2. You may insert up to a full screen of structure statements at 
one time. 


3. The revised structure exists only in your session file. To make 
the insertions permanent, you must resave the structure 
under the same name. 
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5.20. HOW TO PRINT A STRUCTURE (PRINT STRUCTURE COMMAND) 


Purpose You use this command to print a structure from your session file or 
the ESCORT library on the printer. 


When you specify this command, ESCORT: 


Action 1. Gets your structure from your session file or the ESCORT 
library 


2. Prints your structure 


5.21. HOW TO PRINT A LISTING OF STRUCTURE NAMES 
(PRINT STRUCTURE NAMES COMMAND) 


Purpose You use this command to print, on the printer, a list of all structure 


names contained in both your session file and the ESCORT library. 


5.22. HOW TO REMOVE A STRUCTURE FROM THE ESCORT 
LIBRARY OR SESSION FILE 
(REMOVE STRUCTURE COMMAND) 


Purpose You use this command to instruct ESCORT to remove a structure 
from the ESCORT library or your session file. 


Action When you specify this command, ESCORT: 


1. Displays a screen (screen 5-13) on which you identify the file 
from which the structure is to be removed. 


SCREEN 
5-13 





Remove structure 
file selection 
screen 


CHOOSE FROM WHICH FILE YOU WISH TO REMOVE THE STRUCTURE 
1. REMOVE THE STRUCTURE FROM THE SESSION FILE 


2. REMOVE THE STRUCTURE FROM THE LIBRARY FILE. 
3. TERMINATE THE REMOVE OPERATION. 


ENTER SELECTION _ 





2. Removes the structure from the specified file. 


3. Displays a message on the screen confirming that the 
structure has been removed from the file you specified. 
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5.23. HOW TO SAVE A STRUCTURE (SAVE STRUCTURE COMMAND) 

Purpose You use this command to save a structure in the ESCORT library <= 
under a name you specify. Structures are placed in the ESCORT 
library under the type ESFD. For an explanation of library types, see 
5.2. 

Action When you specify this command, ESCORT: 

1. Displays a screen asking what you want to save 


2. Gets a copy of your structure from your session file 


3. Puts it into the ESCORT library under that name <~ 


NOTE: 


Even though you saved your structure, a copy remains on your e 
session file until you terminate your session. 
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5.24. JOB COMMANDS 

Job makeup As you recall, a job is a group of related programs that are 
executed together. As with programs and structures, you can't 
enter or access a job without using one of the job commands. 


The job commands appear on the following menu (screen 5-14): 


SCREEN 
5-14 





JOB COMMANDS 


. ENTER JOB 7. REMOVE JOB FROM WORKFILE 

- RUN JOB 8. REMOVE JOB FROM LIBRARY 

. CHANGE JOB 9. DISPLAY JOB NAMES 

DISPLAY JOB 10. PRINT JOB NAMES 

. PRINT JOB 11. HELP - EXPLANATION OF ABOVE COMMANDS 
. SAVE JOB 12. TERMINATE JOB COMMAND SELECTION 


JOB COMMANDS 
menu 


On Pm wr 


SELECT COMMAND __ JOB NAME 


Command selection Key in the number of the command you want and the job name 
and press the XMIT key. 


We'll explain how to use job commands in 5.25 through 5.34. 


5.25. HOW TO CHANGE A JOB (CHANGE JOB COMMAND) 

Purpose You use this command to change a list of program names 
associated with the RESIDENT job or one stored on your session 
file or the ESCORT library. 

Named jobs When you name your job, ESCORT: 


1. Gets that job from your session file or the ESCORT library 

2. Lets you make your changes 

3. Puts a copy of the changed job into your session file 

NOTE: 

The changes are made only on the session file copy of your job. To 


make the changes permanent, you must resave the job under the 
same name. 
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Unnamed jobs When you don’t name your job, ESCORT: 
1. Gets the job named RESIDENT 
2. Lets you make your changes on the RESIDENT job 
5.26. HOW TO DISPLAY A JOB ON THE WORKSTATION 
(DISPLAY JOB COMMAND) 


Purpose You use this command to display, on the workstation, a job stored 
on your session file or the ESCORT library. 


Named jobs When you name the job you want to display, ESCORT: 


1. Gets that job from your session file or the ESCORT library 





2. Displays the job ®@ 


Unnamed jobs When you don’t name the job you want to display, ESCORT 
displays the RESIDENT job. 


5.27. HOW TO DISPLAY A LISTING OF JOB NAMES 
(DISPLAY JOB NAMES COMMAND) 


You use this command to display, on the workstation, a list of all 
job names contained in both the ESCORT library and your session 
file. 


5.28. HOW TO ENTER A JOB (ENTER JOB COMMAND) 


Purpose You use this command to enter a list of up to eight program 
names, in order of execution, to form a job. 


Named jobs When you name your job, ESCORT stores it in the current session 
file under that name, and you can access it until you terminate 
your session. 


Unnamed jobs When you don’t name your job, ESCORT assigns the default name 
RESIDENT to it, and the job remains RESIDENT for the duration of 
your session or until you enter another unnamed job that 
overwrites it. 
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5.29. HOW TO PRINT A JOB (PRINT JOB COMMAND) 


Purpose You use this command to print, on the printer, a list of program 
names associated with the job specified. 


Named jobs When you name the job you want to print, ESCORT: 
1. Gets that job from your session file or the ESCORT library 
2. Prints your job 


Unnamed jobs When you don't name the job you want to print, ESCORT prints the 
RESIDENT job. 
5.30. HOW TO PRINT A LISTING OF JOB NAMES 
(PRINT JOB NAMES COMMAND) 
e@ Purpose You use this command to print, on the printer, a listing of all job 
names contained in both the ESCORT library and your session file. 
5.31. HOW TO REMOVE A JOB FROM THE SESSION FILE 
(REMOVE JOB FROM WORKFILE COMMAND) 


Purpose You use this command to instruct ESCORT to remove the job you 
name from your session file. 


Action When you specify this command, ESCORT: 
1. Removes the job from the session file. 


2. Displays a screen (screen 5-15) confirming that the job has 
been removed from the session file. 


SCREEN 
5-15 





Job removed 
from workfile 
screen 


JOB REMOVED FROM WORKFILE 


DEPRESS TRANSMIT TO RETURN TO JOB COMMANDS _ 
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5.32. HOW TO REMOVE A JOB FROM THE ESCORT LIBRARY 
(REMOVE JOB FROM LIBRARY COMMAND) 


Purpose You use this command to instruct ESCORT to remove the job you 
name from the ESCORT library. 


Named jobs When you specify this command, ESCORT: 
1. Removes the job from the ESCORT library. 


2. Displays a screen (screen 5-16) confirming that the job has 
been removed from the ESCORT library. 





Job removed 
from workfile 
screen 


JOB REMOVED FROM LIBRARY 


DEPRESS TRANSMIT TO RETURN TO JOB COMMANDS _ 





5.33. HOW TO EXECUTE A JOB (RUN JOB COMMAND) 


Purpose You use this command to execute the RESIDENT job or one stored 
on your session file or the ESCORT library. 


Named jobs When you name the job you want to execute, ESCORT: 
1. Gets that job from your session file or the ESCORT library 
2. Executes your job 


Unnamed jobs When you don't name the job you want to execute, ESCORT 
executes the RESIDENT job. 
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5.34. HOW TO SAVE A JOB (SAVE JOB COMMAND) 


Purpose 


Named jobs 


Unnamed jobs 


You use this command to save a job in the ESCORT library under a 
name that you specify. Jobs are placed in the ESCORT library 
under the type ESCJ. For an explanation of library types, see 5.2. 
When you name the job you want to save, ESCORT: 

1. Gets a copy of that job from your session file 

2. Puts it in the ESCORT library under that name 

NOTE: 


Even though you've saved your program, a copy remains on your 
session file until you terminate your session. 


When you don’t name the job you want to save, ESCORT assumes 
you want the RESIDENT job, but you must rename it before you 
can save it because you can’t save a job under the name 
RESIDENT. 


5.35. PASSWORD COMMANDS 


Password 
requirements 


Password commands are session oriented and allow you to specify 
during each ESCORT session any passwords required for the files 
you plan to use during the session. Passwords for a file must be 
made known to ESCORT before execution of any program that 
references that file. No password information is retained by 
ESCORT at the end of a session. 


The password commands are shown on the following menu screen 
(screen 5-17). 
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SCREEN ee Re t 
5-17 __. 





Password commands 
menu 


PASSWORD COMMANDS 

. ENTER OR CHANGE PASSWORDS 

. DISPLAY PASSWORDS OF FILE 

. REMOVE PASSWORDS OF FILE 

. HELP - EXPLANATION OF ABOVE COMMANDS 

. TERMINATE PASSWORD COMMANDS 
SELECTION _ 


oP wn 


ENTER FILE NAME BELOW FOR COMMANDS 2 & 3 ONLY 


FILE NAME 





5.36. HOW TO DISPLAY THE PASSWORDS OF A FILE ON THE 
WORKSTATION (DISPLAY PASSWORDS OF FILE COMMAND) 





Purpose You use this command to display the previously entered passwords 
for a file on the workstation. } 
Action When you specify this command, ESCORT: 


1. Gets the passwords entered for the file during this session. 
2. Displays the file name and passwords (screen 5-18). 


SCREEN FP 
5-18 im 


Display passwords FILE NAME 
Screen 
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5.37. HOW TO ENTER OR CHANGE THE PASSWORDS OF A FILE 
(ENTER OR CHANGE PASSWORDS COMMAND) 


Purpose You use this command to enter or change file passwords from the 
workstation. When this command is executed, screen 5-19 
appears. 


SCREEN err 
5-19 ~ 
READ WRITE 


FILE NAME PASSWORD PASSWORD 






Enter/change 
passwords screen 








Enter file names and passwords as needed for your use during the 
current session. 


To change or correct passwords previously entered, simply reenter 
the file name and supply the revised passwords. ESCORT 
automatically replaces the passwords when a duplicate file name is 
entered. 


5.38. HOW TO REMOVE THE PASSWORDS OF A FILE 
(REMOVE PASSWORDS OF FILE COMMAND) 


You use this command to remove the file name you specify and its 
associated passwords from the ESCORT session. 
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5.39. HOW TO TERMINATE AN ESCORT SESSION 
(TERMINATE CURRENT ESCORT SESSION COMMAND) 





When you are ready to end your ESCORT session, choose selection 
1, TERMINATE CURRENT ESCORT SESSION, from the COMMAND 
SELECTION menu (screen 5-1). The following screen (screen 5-20) 
appears, asking if you want to save your session file. 


SCREEN 
5-20 


DO YOU WANT TO SAVE YOUR CURRENT SESSION FILE(WORKFILE)? 
1F NO - DEPRESS TRANSMIT KEY 
(F YES - KEYIN THE FILE NAME USED FOR SAVING WORKFILE 





NOTES: 


1. THE FILE NAME USED FOR SAVING WORKFILE MUST BE CATALOGUED. 

2. THE WORKFILE IS A SCRATCH FILE (TEMPORARY) THAT IS LOST 
WHEN TERMINATING AN ESCORT SESSION UNLESS SAVED. 

3. THE SAVING OF THE WORKFILE ALLOWS YOU TO START ANOTHER 
ESCORT SESSION LATER WITH THE CURRENT EXISTING WORKFILE 
BY USING THE RECOVER FUNCTION ON THE INITIAL MENU OF ESCORT. 


Saving your session file allows you to recover its contents when 
you initiate another ESCORT session. The RECOVER function is 
described in 2.3. 


If you want to save your session file, enter the name of a file on 
which its contents are to be saved. Remember that the file you 
name must be cataloged. 


If the file you name is password protected, the following message 
appears at the bottom of the screen: 


ESC117 RECOVERY/SAVE REQUIRES PASSWORD 
ENTER READ OR WRITE PASSWORD 


Enter either password for the file. When the other password is 
required, it is requested. 
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6. ESCORT Files and Structures 


6.1. UNDERSTANDING FILES 


Field defined 


Kinds of fields 


Record defined 


File defined 


Example 


This section deals with ESCORT file types and creating a file struc- 
ture. Before we discuss file types, however, familiarize yourself with 
the following terms: 


Field 

The smallest unit of an ESCORT file. Each field holds an 
individual piece of data. There are two kinds of fields: system 
utility fields (6.9), which the system supplies, and variable data 
fields, which you supply. 

Record 


A group of fields relating to a specific item. For example, a bank 
account record for each customer. 


File 


A group of related records taken as a whole. For example, all 
the bank records contained in a master file. 


Perhaps a simpler way of understanding files is to picture a filing 
cabinet of employee personnel folders. Each folder is a record for a 
specific employee. Each record is broken down into fields (name, ad- 
dress, etc), and all the records contained in the filing cabinet make 
up a file. 


SANE : 
2 eM Sio. nx 
ESS Lypwod! 


NAME 


Apohl 
ey: 
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Now that you understand ESCORT file terminology, let’s look at the 
two different types of ESCORT files available. 


6.2. TYPES OF FILES 


ESCORT data 
file types 


MIRAM file types 


Organization 


Organization 


ESCORT creates and uses exclusively MIRAM (multiple indexed 
random access method) data files and can also access MIRAM data 
files created by another processor, such as COBOL. Further 
information on the use of files created by another processor is 
given in Appendix D. 


There are two types of MIRAM data files: indexed and nonindexed. 


Indexed Files 


An indexed file contains data records and an index of record keys. 
Each record key points to a certain record in your file. 


Data records appear in a file in the order you enter them, and the 
record keys are arranged in ascending order. 


RECORD KEY AREA . DATA RECORD AREA | 





Record keys point to data records. 


You can process indexed files in two ways: 
= Randomly, by specifying the key of the record 


a Sequentially, by beginning with the lowest key value 


Nonindexed Files 


A nonindexed file is organized sequentially. This means the records 
appear in a file in the order you enter them, and they are 
processed in this order. 
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Nonindexed files are organized sequentially and are processed in that order. 


For more information on MIRAM files and access methods, see the 
consolidated data management concepts and facilities manual. 


Now that you know the kinds of files that are available, let’s see how 
you allocate them. 


6.3. ALLOCATING FILE SPACE 


Allocating 
files for 
ESCORT 


Sample interactive 
services ALLOCATE 
command 


Calling general 
editor (EDT) 


Before you can create files in ESCORT, you must first catalog the 
files you need. When you don’t have any space allocated in 
storage, begin in interactive services with the ALLOCATE 
command. For example: 


AL ST, FIL=MYJOB,VSN=MYPAC,SI=1 


AL is the abbreviation for ALLOCATE. ST stands for SAT file. FIL 
names the file where you plan to store your ESCORT programs. 
VSN names the volume where your files are stored. SI indicates 
the size of the area you're allocating. The interactive commands 
and facilities user guide/programmer reference has more 
information on the ALLOCATE command. You can also allocate 
space with OS/3 job control statements. 





When your ALLOCATE command is accepted, call the general 
editor by keying in EDT. EDT prompts you with a line number and 
an SOE. You're now ready to key in the job control stream that 
catalogs your files. 
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Job stream 
for System 
80 


Sample 
job control 
stream 


Explanation 


Executing 
stream from 
ESCORT 


Alternate 
job stream 


Example 
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If you're using a System 80, the following job stream is best for 
you. You should catalog the stream itself so you can reuse it. 
The job stream prompts you for the three pieces of information 
listed in the QGBL statement. When you key in the DVC, the 
VSN, and the file name, your file is cataloged. 


-8066 // JOB ESC.CAT 


1 

2.6988 // JNOTE “DVC = 176 FOR FIXED DISK, 68 FOR REMOVABLE’ 
3.6668 // QGBL DVC.VSN,FILENM 

4.0008 // OVC &DVC // VOL &VSN 

5.0008 // LBL &FILENM // LFO TEST 

6.6608 // CAT TEST 

7.60868 /& 


The file name in the CAT statement must be the same as the file 
name in the LFD statement. Terms preceded by the ampersand (&) 
are variables that you should fill in when you first key in the job 
stream. 


When you're already in ESCORT and you want to execute the job 
stream, you can issue an RV command without leaving ESCORT. 
See the job control user guide for more information on job control 
statements. See also the file cataloging concepts and facilities 
manual for further information on the file cataloging facilities. 


If you're using a system other than System 80, use this job stream, 
which doesn’t prompt you for input. You can easily change the 
stream when you want to catalog additional ESCORT files. To 
execute this stream, key in an RV command. 


-6808 // JOB MYCAT 

-0808 // DVC 58 // WOL MYPAC 
-8808 // LBL ESCORT. MY 

-0808 // LFD MYFILE 

-0868 // CAT MYFILE 

-8680 /& 

-86990 @WRITE MYCAT .MYESC ,MYPAC 
-6896 @D 

-89068 // JOB MY 

- 8008 // LBL ESCORT .MY 

- 6668 // EXEC PROG) 

-8890 /8& 

- 8086 @WRITE MY .MYESC.MYPAC 


Okw ne NN OO & wR 














UP-8855 Rev. 1 








Explanation 
of 
statements 


Changing 
stream to 
add files 


ESCORT 
library 
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The first @WRITE statement writes the job MYCAT to the file 
MYESC. The @D statement returns the line number to line 1. The 
second @WRITE statement writes the job MY to the file MYESC. 
One RV statement executes both job streams. When you want to 
add new files to your catalog, call the general editor (EDT) by 
keying in EDT, and change only those statements that contain file 
names you want altered. See the job control user guide for more 
information on job control statements. 


ESCORT requires a MIRAM library named 
ESCSESCORT.LIBRARY.FILES for storage of all structures, 
programs, and jobs. Presently, ESCORT automatically allocates a 5- 
cylinder library on the RES disk the first time ESCORT is entered. 


Once your file name is in the catalog, ali you have to do is create 
your file in tutorial mode or in program mode by using the ENTER 
DATA program statement and the CREATING clause. ESCORT rules 
for file names are given in detail in 7.20. 


When ESCORT interprets the CREATING clause, it goes to the file 
catalog and finds your file name. It then goes to your structure and 
determines the key (sort keys) you designated. Then ESCORT 
allocates space for your file. 
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6.4. HOW TO BUILD A FILE STRUCTURE 


Structure defined 


Entering a structure 


Structure statement 
makeup 


Now that you're familiar with the types of ESCORT files and how to 
allocate space for them, let’s look at file structures. 


As you recall from Section 1, you use structures to tell ESCORT 
what your data records look like. You use one or more structure 
statements to build a structure. 


STRUCTURE 
STATEMENT 
! 


i 
STRUCTURE § STRUCTURE 
STATEMENT § STATEMENT 





You build (enter) a structure by using a screen menu provided by 
ESCORT. But before you do this, you should familiarize yourself 
with structure statement makeup. That is, you should know about 
the required and optional parts of a structure statement. 


We'll tell you about these things and then explain how to enter and 
change a structure. Then, we'll tell how to manipulate your 
structure by using other structure commands. 
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6.5. STRUCTURE STATEMENT MAKEUP 


Function of structure Structure statements specifically define individual fields within your 
statements file by telling ESCORT exactly what those fields look like. You enter 
structure statements on this screen (screen 6-1): 


SCREEN 
6-1 
LENGTH/ EDIT REPEAT START 


FLELDNAME TYPE KEYS CODES COUNT POSITION 














Required parts of a As you can see, there are six parts to a Structure statement, but only 
structure statement two are required: 
a FIELDNAME pENGTR 
FIELONAME TYPE 


m LENGTH/TYPE 





Optional parts of a The other four parts are optional, and each performs a different 
structure statement fu nection: 
e» KEYS , 
EDIT REPEAT START 
2 EDIT CODES KEYS CODES COUNT POSITION / 


@ REPEAT COUNT - moe aa — 


= START POSITION 





UP-8855 Rev. 1 SPERRY UNIVAC OS/3 6-6 
ESCORT 


6.6. REQUIRED PARTS OF A STRUCTURE STATEMENT 


FIELDNAME 


Identifying the data To identify each piece of data you put into a file, you must assign 
field names. 


SMITH, W.C. 


- (an3762 





Format Field names (also called variable data names) consist of one to 
eight alphanumeric characters of which the first must be 
alphabetic. We'll give some additional rules on field names in 6.8. 


You can’t use ESCORT reserved words (Appendix B) or any 
Restrictions punctuation or special symbols in field names. 


The following examples show correct and incorrect use of field 
Examples names. 





First character numeric 








1ACCTNO 





ACCTNO1 


DATAONE DATA ESCORT reserved word 
TRANOO1 TRAN.OO1 Punctuation not allowed 
KAPHIL KA*PHIL Symbols not allowed 
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LENGTH/TYPE 


You must specify how much and what kind of data you want to 
include in each field: 





Alphanumeric 4092 characters 
Numeric 15 digits 
Assumed decimal 15 digits 
Packed decimal 15 digits 

Binary 9 digits 


LENGTH is a numeric designation of how many characters are in 
the field. For example, a 5-number zip code has a LENGTH of 5. 


TYPE specifies the kind of data. The five types of data you can 
place in your fields are: 


Alphanumeric 


Alphanumeric fields contain letters, numbers, and special 
symbols, including punctuation. 


The maximum length for an alphanumeric field is 4092 
characters, and each character occupies one byte of storage. 


Alphanumeric fields are represented in your structure by the 
letter A in the LENGTH/TYPE column of your ENTER 
STRUCTURE screen (screen 6-4). 


Examples of alphanumeric fields are: 











NAME 12 letters 


ADDRESS 25 letters and numbers 25A 


CITY 30 letters and punctuation 30A 
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Structure representation 


Examples 


Assumed decimal fields 


Length 


Sign handling 
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Numeric 


Numeric fields contain only integers, or whole numbers. Any 
other designation results in an error. 


The maximum length for a numeric field is 15 digits. 


Each digit occupies one byte in storage, and the sign is 
handled as an overpunch in the last digit, so you need not 
leave an extra space for a sign when entering negative 
numbers. 


Because of the way ESCORT handles numeric data, when you 
include a sign in numeric fields you must designate this in the 
LENGTH/TYPE column by placing an S before the length 
designation. For example, a 5-digit numeric field that will 
contain negative values is written: SSN. You must include the 
“—" edit code in the statement specification. 


Numeric fields are represented in your structure by the letter 
N in the LENGTH/TYPE column of your ENTER STRUCTURE 
screen (screen 6-4). 


Examples of numeric fields are: 







ZIPCODE 5 integers 5N 
ACCTNO 7 integers 7N 
INVNO 10 integers 10N 






Assumed Decimal 
Assumed decimal fields contain integer and decimal digits. 


The length of assumed decimal fields is broken into numbers 
appearing before the decimal point and numbers appearing 
after the decimal point. The combined length of an assumed 
decimal field may not exceed 15 digits. The decimal portion 
may not exceed nine digits. 


Each digit occupies one byte in storage; however, the sign is 
handled as an overpunch in the last digit, so you need not 
leave an extra space for a sign when entering negative 
numbers. 
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Structure representation 
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Because of the way ESCORT handles decimal data, when you 
include a sign in assumed decimal fields you must designate 
this in the LENGTH/TYPE column by placing an S before the 
length designation. For example, a 5-digit, 2-decimal field that 
will contain negative values is written: S5V2. You must 
include the ‘-’’ edit code in the statement specification. 


Assumed decimal fields are represented in your structure by 
the letter V in the LENGTH/TYPE column of your ENTER 
STRUCTURE screen (screen 6-4). 


Examples of assumed decimal fields are: 







ACCTBAL 6 integers, 2 decimals 





TOTFUNDS 13 integers, 2 decimals 13V2 


INFLRATE 3 integers, 5 decimals 3V5 


Packed Decimal 


Packed decimal fields contain integer and decimal numbers 
that are compressed or expanded internally for calculation, 
display, and storage purposes. When you view these fields 
from a workstation display, they appear as standard numeric 
fields. 


The length of packed decimal fields is broken into numbers 
appearing before the decimal point and numbers appearing 
after the decimal point. The combined length of a packed 
decimal field may not exceed 15 digits. The decimal portion 
may not exceed nine digits. 


Each two digits of a packed decimal occupy one byte of 
storage except for the least significant digit (the digit farthest 
to the right) and the sign, which occupy one byte of storage 
together. 


When the value in the field may be negative, you must 
include the ‘‘—’’ edit code in the statement specification. 


Packed decimal fields are represented in your structure by the 
letter P in the LENGTH/TYPE column of your ENTER 
STRUCTURE screen (screen 6-4). 
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Examples of packed decimal fields are: 










PACKONE 





5 integers, 2 decimals 


KAPHIL 10 integers, 5 decimals 10P5 


DAVIDFIL 3 integers, 2 decimals 3P2 





Binary 


Binary fields consist of integers, or whole numbers, and are 
stored in binary notation. 


The maximum length for a binary field is nine digits. 


Depending on the length of your field, your data takes up the 
following bytes of storage: 





When you plan to use a binary field to represent negative 
numbers, you must designate the negative sign as an edit 
code in the EDIT CODES column of your ENTER STRUCTURE 
screen. 


When the value in the field may be negative, you must 
include the ‘‘—’’ edit code in the statement specification. 


Binary fields are represented in your structure by the letter B 
in the LENGTH/TYPE column of your ENTER STRUCTURE 
screen (screen 6-4). 


Examples of binary fields are: 







BIFILE 





5 integers 


GREENFIL 9 integers 9B 





WORKORD 2 integers 2B 
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6.7. OPTIONAL PARTS OF A STRUCTURE STATEMENT 


Use of sort keys 


Indexed files 


Nonindexed files 


Matching criteria entry 


Use of matching criteria 


Types of matching criteria 


Choosing a type 


Index key fields 


Uses 


KEYS 


Sort keys are fields in your structure you use to sort your data in a 
specific order. 


When you have an indexed file, you designate index key fields as 
your sort keys. When you have nonindexed files, you use matching 
fields. 


The KEYS portion of your ENTER STRUCTURE screen allows you to 
designate a field as an index key field or a matching field. 


The entry you make is called the matching criteria. 

When you need data from more than one file or device, you use 
matching criteria to define the file to the system so it can 
determine the input/output instructions it needs to generate and 
use in the program. 

There are three types of matching criteria: 

= §=Index key 

= Matching sorted 


= Matching unsorted 


Because your files can be indexed or nonindexed (6.2), the type of 
criteria you use depends on the type of file you choose. 


= ~=Indexed Files Use Index Key Fields 


Index key fields are the matching criteria for indexed files. 
Designate up to five index key fields per structure by entering 
Ki through K5 in the KEYS portion of your ENTER 
STRUCTURE screen. Use index keys only with indexed files; 
you can't use them in a structure that has matching key fields. 
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When you create a file with multiple keys, you can access the file 
randomly by any one of the keys. You indicate which key to use by 
creating alternate structures for your file. 


In the following example, the structure NAMEADDR has three 
keyed fields. 


STRUCTURE NAMEADDR 


LENGTH/ 
FIELDNAME TYPE KEYS 


CUSTNO 5N K1 
NAME 15A K2 


ADDR 15A 
CITY 12A 
STATE 2A 
ZIP 5N 





CUSTNO (customer number) is the primary key. NAME and STATE 
are secondary keys. When you execute this program: 


ENTER DATA FROM WS CREATING NAMEADDR 


the file NAMEADDR is created with three keys. The file may later 
be accessed by CUSTNO, NAME, or STATE. Assume the following 
data is entered: 


CUSTNO NAME ADDR CITY STATE ZIP 

16325 SMITH JOHN 111 OAK LANE PHILADELPHIA PA 19624 
59999 JONES MARY PO BOX A TRENTON NJ 28355 
35411 DOE JANE 1528 ESSARY KNOXVILLE TN 37918 
72768 THOMAS JAMES 78 HILL AVENUE LANCASTER PA 19455 


You can use the structure NAMEADDR to access the file by the 
primary key, CUSTNO. When the structure applied to your file has 
more than one key designated, the primary key (K1) is used. 


When you use this SELECT DATA program, the output is organized 
in CUSTNO sequence because CUSTNO is the field designated K1: 


SELECT DATA OF NAMEADDR PRINT 
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e The output of this program is: 
CUSTNO NAME ADDR CITY STATE ZIP 
18325 SMITH JOHN 111 OAK LANE PHILADELPHIA PA 19824 
35411 DOE JANE 1528 ESSARY KNOXVILLE TN 37918 
59999 JONES MARY PO BOX A TRENTON NJ 20355 
72768 THOMAS JAMES 78 HILL AVENUE LANCASTER PA 19455 


An inquiry program, such as, 


SELECT DATA OF NAMEADDR FROM WS DISPLAY 


returns a workstation prompt for the field CUSTNO. When you 
enter a value, the record whose CUSTNO value matches the value 
entered is displayed on the workstation screen. 


Accessing To access the file by a secondary key, you must create an alternate 
Ad secondary structure. To output a listing of the file NAMEADDR in NAME or 
eys 


alphabetic order, you need to create the following alternate 
structure, NAMEADD2. 


Alternate STRUCTURE NAMEADD2 
structure 
for K2 
} LENGTH/ 
FIELDNAME TYPE KEYS 


CUSTNO 5N 





Then the program 


SELECT DATA OF NAMEADDR (NAMEADD2) PRINT 


Output produces the following listing: 

arranged 

by secondary 

key CUSTNO NAME ADDR CITY STATE ZIP 
35411 DOE JANE 1520 ESSARY KNOXVILLE TN 37918 
59999 JONES MARY P 0 BOX A TRENTON NJ 20355 
19325 SMITH JOHN 111 OAK LANE PHILADELPHIA PA 19924 
72768 THOMAS JAMES 78 HILL AVENUE LANCASTER PA 19455 
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6—10d 





In the preceding program, the structure name ts not the same as 
the file name. Therefore, it is necessary to include the structure 
name in parentheses. When the structure name is the same as the 


file name, you don't need to list any structure name at all. 


The inquiry program 


SELECT DATA OF NAMEADDR (NAMEADD2) FROM WS DISPLAY 


returns a workstation prompt for the field NAME. 


The following structure allows access to the file NAMEADDR by 
the third key, STATE. 


The program 


STRUCTURE NAMEADD3 


LENGTH/ 
FIELDNAME TYPE KEYS 


CUSTNO 5N 
NAME 

ADDR 

CITY 

STATE 

2ziP 





SELECT DATA OF NAMEADDR (NAMEADD3) PRINT 


produces the listing in order by STATE: 


CUSTNO 


59999 
18325 
72768 
35411 


NAME ADDR CITY STATE ZIP 

JONES MARY PO BOX A TRENTON NJ 20355 
SMITH JOHN 111 OAK LANE PHILADELPHIA PA 19624 
THOMAS JAMES 78 HILL AVENUE LANCASTER PA 19455 
DOE JANE 1528 ESSARY KNOXVILLE TN 37918 
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The customer number and name fields contain unique values. The 
state is not unique; it contains duplicates. When key matching from 
an input file or the workstation is present, ESCORT can’t access all 
records having duplicate values. Therefore, the program 


SELECT DATA OF NAMEADDR (NAMEADD3) FROM WS DISPLAY 


presents a workstation prompt for the field STATE. But when a 
value, for example PA, is entered, only the first record found with 
STATE equaling PA is displayed. You can select all records with 
duplicate fields by not using key criteria. This program shows one 
way to do this: 


SELECT DATA OF NAMEADDR 
IF STATE = ‘PA’ DISPLAY END 


This program has to be changed and recompiled if the selection 
changes. 


Another technique accomplishes this task and eliminates the need 
for changing the program. You need an additional file, here named 
SEARCH, with the following structure: 

STRUCTURE SEARCH 


LENGTH/ 
FIELDNAME TYPE KEYS 


STATE 2A K1 





In the following program, enter a value for STATE, such as PA, 
when prompted. When the prompt appears again, press the 
FUNCTION and F4 keys to terminate input to the program. 


ENTER DATA FROM WS CREATING SEARCH 


Then execute this second program. 


SELECT DATA OF NAMEADDR 
USING SEARCH 
IF STATE = STATE OF SEARCH DISPLAY END 


All records where STATE equals PA are displayed. To get all 
records containing NJ, rerun the two programs, entering NJ 
instead of PA. You can place the programs in an ESCORT job so 
that a single job is run instead of two programs. You can use this 
technique on any fields that contain duplicate values. 
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Matching fields 


Types of matching fields 


Matching sorted 


Structure representation 


Matching unsorted 


Structure representation 


Restrictions 


Matching criteria with a 
device 
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Nonindexed Files Use Matching Fields 





Nonindexed files have no index key fields, but use a specific 
data field as the matching criteria. In nonindexed files, records 
are stored sequentially and may or may not be sorted; 
therefore, there are two kinds of matching criteria you can 
enter in the KEYS portion of your ENTER STRUCTURE screen: 
matching sorted and matching unsorted. 


- Matching Sorted (MS) 
Tells the system the matching data field is contained in 
an unkeyed file that is sorted in ascending order 


according to that data field. 


To designate matching sorted in the KEYS portion of your 
structure, key in MS. 


- Matching Unsorted (MU) 


Tells the system that the matching data field is contained 
in an unkeyed file and the data records are not in order. 


To designate matching unsorted in the KEYS portion of 
your structure, key in MU. 


You can’t use matching for a sorted (MS) and an unsorted 
(MU) file in the same structure or in an indexed file structure. 


Applying Matching Criteria to a Device 


You can also use matching criteria when you apply a structure 
to a device, such as a workstation. 


For example, when you use the workstation as an input 
device, the matching criteria field supplies the prompt field for 
selection of a record from a disk file. 
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Function 


Symbols and functions 


Function 


@ Array fields defined 


EDIT CODES 


The EDIT CODES column of your ENTER STRUCTURE screen lets 
you specify symbolic editing codes that perform certain functions 
on numeric fields when you output them to the printer or 
workstation. Table 6-1 lists the edit code symbols and their 


functions. 


Table 6-1. Edit Codes 





*$ 


NOTE: 


Suppress leading zeros 


Replace leading zeros with asterisks 
Insert commas where applicable 
Insert sign after least significant digit 
If the number is: 
Positive - the sign inserted is a blank character 
Negative - the sign inserted is a minus symbol 
Insert slash character where applicable in date field 
In 4-digit date field, one slash is inserted. 
In 6-character date field, two slashes are inserted. 
Insert fixed dollar sign 


Fixed dollar sign is assumed when the asterisk is in the 
first position of the field. 


Insert floating dollar sign 


Floating is assumed when the asterisk is omitted. 


When using a form to output your data, the slash, sign, comma, and decimal point codes are 
characters that are added to the field and should be allowed for in your output. For example, 
to output a 5V2 field with a comma, you must allow for nine positions: eight for the number 


and decimal point and one for the comma. 


REPEAT COUNT 


You use the REPEAT COUNT column of your ENTER STRUCTURE 
screen to specify the number of times an array field is repeated 
contiguously in the record. 


Array fields are fields of similar data that occur several times and 
have the same data type and length for each occurrence. Instead of 
specifying fields individually, you specify them as one array field. 
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Example of array field Let’s assume you want an array field named MONTHS that lists a 3- 
character abbreviation for each month. 





An example of the array MONTHS looks like this: 


i [2 fs [« [s Je [7 |s [9 fia far [re | 
[JAN [FEB] MAR] APR|MAY|JuN[sut[aue|sePloct|Nov|DEC| 


Specifying array fields To specify this field in your structure as an array field, you fill in the 
in a structure following columns on your ENTER STRUCTURE screen: 

FIELDNAME LENGTH/TYPE REPEAT COUNT 

MONTHS 3A 12 


This means your field named MONTHS is 3. alphanumeric 
characters long and occurs 12 times. 


Referencing array fields To reference a certain month of the array in a program, specify the 

in a program field name and the occurrence number you want, and ESCORT 
gets it for you. For example, when you want September, you 
specify MONTHS (9) in your program. This tells ESCORT to 
reference the ninth item in the array named MONTHS. 





START POSITION 


Use The optional START POSITION column of your ENTER STRUCTURE 
screen lets you designate a specific record position for a data field 
to begin. When you don’t use this column, ESCORT automatically 
assigns positions, beginning with position 1. 


START POSITION is especially helpful when you want to define 
more than one field name to occupy the same record position 
(overlay) because it lets you reference a specific part of a field. For 
example, assume you want to specify a field named DATE. Within 
this field, you have the month, day, and year, which you may want 
to reference individually at some point. Fill in the following portions 
of your ENTER STRUCTURE screen: 


FIELDNAME LENGTH/TYPE START POSITION 


DATE 6N 1 
MONTH 2N 1 
DAY 2N 3 . 
YEAR 2N 5 x 


Since MONTH, DAY, and YEAR occupy the same record positions 
as the field DATE, you can reference individual parts of the field by 
specifying any one of them in your program. Se 
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For example, when you want only the month portion of the DATE 
field printed, you specify MONTH, and you only get the month. 
When you want the entire date, just specify DATE. 


Overlay field When you designate an overlay field in a structure, ESCORT places 
an asterisk after the START POSITION column of the structure. 


Placement of asterisks Where the asterisk is placed depends on the order in which you 
specify the fields. In the preceding example, the asterisks appear 
after the MONTH, DAY, and YEAR fields because the field DATE 
precedes them in the structure. If the fields MONTH, DAY, and 
YEAR were entered in the structure before the field DATE, the 
asterisk would be on the DATE field. 


6.8. VARIABLE NAME QUALIFIERS QUALIFY FIELD NAMES 


Purpose There are no set rules for the number of times you can use a 
variable data (field) name in different structures. But when you use 
the same name more than once, you can run into problems when 
using multiple files in a program. For this reason, ESCORT lets you 
distinguish which file name you want by using variable name 
qualifiers. 


Use Variable name qualifiers, as their name implies, tell the system 
exactly which file structure the field name is in. When you 
reference two structures containing the same field name in a 
program and don’t use variable name qualifiers, the system default 
selects the field based on the order of the file’s appearance in the 


program. 
Example Consider the following structures: 
MASTVEND TRANVEND NAMESHIP 


‘| VNUMBER | VNUMBER — 5N Mu| || VNAME 20A 
VNAME AMTPAID = 5V2 VADDRESS 30A 


VADDRESS COST 4V2 VCITY 30A 
. ssi A 2 





Based on these structures, the following examples show two 
methods for using variable name qualifiers. 


Example 1 You can use variable name qualifiers by specifying the file name: 
1F VNUMBER OF MASTVEND=VNUMBER OF TRANVEND 
or 


IF VNAME OF NAMESHIP CONTAINS ‘‘HATFIELD’’ 
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Example 2 


Example 3 
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When you don’t use variable name qualifiers, ESCORT chooses the 
field based on the order of the file’s appearance in the program. 


If your program is: 


SELECT DATA OF MASTVEND FROM TRANVEND USING 
NAMESHIP 


the following table shows how ESCORT attributes the following 
clauses using field names. 




















IF VNUMBER>500 VNUMBER OF MASTVEND Because 
MASTVEND is the 
first file containing 
the field VNUMBER 
named in your 


program 





Because 
MASTVEND is the 
first file containing 
the field VNAME 
named in your 
program 





IF VNAME STARTS WITH “STA” VNAME OF MASTVEND 












Because 
TRANVEND is the 
first file containing 
the field AMTPAID 
in your program 


COMPUTING AMTPAID=COST*1.5 | AMTPAID OF TRANVEND 


Another way of using variable name qualifiers is to use a 
combination of the previous two examples: by file name and by the 
order of appearance. 


If your program clause reads: 


IF VNUMBER=VNUMBER OF TRANVEND 


ESCORT interprets the VNUMBER on the left side of the equal sign 
to be contained in the structure MASTVEND because it’s the first 
file mentioned in the program that contains the field VNUMBER. 
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If your program clause reads: 


COMPUTING AMTPAID=AMTPAID OF NAMESHIP 


ESCORT interprets the AMTPAID on the left side of the equal sign 
to be contained in the structure TRANVEND because it’s the first 
file mentioned in the program that contains the field AMTPAID. 


6.9. SYSTEM UTILITY FIELDS 


Function 


How to distinguish 


In addition to field names you supply, there are also eight system 
utility fields you can reference in any ESCORT statement. These 
fields perform often used functions, such as date, time, and report 
titles, and save you the trouble of programming these fields 
yourself. 


System utility fields (Table 6-2) are distinguishable from variable 
fields by the dollar sign ($) prefix. 


Table 6-2. System Utility Fields 





SDATE 8A Gives you the current system date (mm/dd/yy) 

SDAY Gives you the current system day 

SLINE ee Sets the system printer to a specified line number before 
printing. (See Appendix D for expanded capabilities.) 

SMONTH Gives you the current system month 

SPAGE pan | Sets the system page number to a specific page number 

STIME Gives you the current system time (hh:mm) 

STITLE aoa | Allows you to provide a title line for printed reports 

SYEAR Gives you the current system year 
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6.10. HOW TO ENTER A STRUCTURE 


Entering a structure 


Command selection 
menu 


STRUCTURE COMMANDS 


menu 
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Now that you know what's required for structure statements, you‘re 
ready to enter your own. 


As you recall, when you enter program mode the first screen you 
get is the command selection menu (screen 6-2): 


SCREEN 
6-2 : 


he as SELECT ONE OF THE FOLLOWING FUNCTIONS **°"°* 
1. TERMINATE CURRENT ESCORT SESSION 

TUTORIAL MODE OF OPERATION 

STRUCTURE COMMANDS 

PROGRAM COMMANDS 

JOB COMMANDS 

PASSWORD COMMANDS 


SELECTION 





rPmnewn 


Since you want to enter a_ structure, choose number 3, 
STRUCTURE COMMANDS, and screen 6-3 appears: 





SCREEN Fe 
; 6-3 






STRUCTURE COMMANDS 





: 1. ENTER STRUCTURE 7. REMOVE STRUCTURE 
- 2. CHANGE STRUCTURE 8. INSERT INTO STRUCTURE 
Ss 3. SAVE STRUCTURE 9. PRINT STRUCTURE NAMES 
- 4. DISPLAY STRUCTURE 10. HELP - EXPLANATION OF COMMANDS 
. 5. DISPLAY STRUCTURE NAMES 11. HELP - EXPLANATION OF STRUCTURES 
. 6. PRINT STRUCTURE 12. TERMINATE STRUCTURE PROCESSOR 
. ENTER SELECTION STRUCTURE NAME — 


Now you pick the operation you want. Since you want to enter a 
structure, pick number 1, ENTER STRUCTURE, and name your 
structure. (The sample structure is named INVNTORY.) 


Structure names are one to eight characters long. They must begin 
with a letter (A-Z) and contain only letters and numbers (0-9). 
Often, a structure name is the same as the file name or the first 
eight characters of a longer file name. ESCORT rules for file names 
and associated structure names are detailed in 7.20, the 
CREATING clause. 
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@ Now screen 6-4, the ENTER STRUCTURE screen, is displayed: 
SCREEN F. . a ee 
6-4 
LENGTH/ EDIT REPEAT START 
FIELONAME TYPE KEYS CODES COUNT POSITION 
ENTER STRUCTURE cones a Sf - ee 
screen oe vnaens os bs, Aaa, 
Entering the structure Fill in the blanks with structure statements. Remember, only the 
FIELDNAME and LENGTH/TYPE portions are required. 
Moving from field To move the cursor across the line to each column, press the TAB 
to field key. To go back to previous fields, press the TAB BACK key. To 


move to the next input line, press the RETURN key. 
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ESCORT 
When you key in some structure statements, your screen looks like 
this (screen 6-5): 
py SCREEN FF 
LENGTH/ EDIT REPEAT START 
FIELDNAME TYPE KEYS CODES COUNT POSITION 


Completed structure 


PRODNO 
Screen 


PRODESC 
UNIT 
UNITCOST 
MARKUP 
RETPRICE 
QONHAND 





QONORDER 
REORDERL 
QUANDISC 
VENDNAME 
VENDADDR 
VENDZIP 











Processing the To process your structure, press the XMIT key. When a blank 

structure screen appears, press the FUNCTION and F1 keys. Then the 
STRUCTURE COMMANDS menu (screen 6-3) reappears so you can 
perform your desired processing. 


Now, we're ready to discuss changing your structure (6.11) and the 
various command options available to you in processing your struc- 
ture (6.12). 





UP-8855 Rev. 1 SPERRY UNIVAC OS/3 6-21 
ESCORT 





& 6.11. HOW TO CHANGE A STRUCTURE 


To change a structure, pick choice 2, CHANGE STRUCTURE, on the 

STRUCTURE COMMANDS menu (screen 6-3). Screen 6-6 then 
Keying in appears, and you make your changes. Key in any changes over the 
changes existing entries. 


SCREEN F- 
6-6 


CHANGE STRUCTURE INVNTORY 








LENGTH/ EDIT REPEAT START 
FIELDNAME TYPE KEYS CODES COUNT POSITION 
PRODNO 7N Kl sak oe Bosc 
PRODESC 25A eae eee ire teen 
UNIT 5A hes Rae ssa Sees 
UNITCOST 4V2 ak 2226 woe — ale 
MARKUP 1¥2 os Bote papers once 
ESCORT displays RETPRICE 5V2 =m wee —— ee 
structure to be QONHAND 5N es Seca ea Stes 
changed QONORDER 5N be panes rears joes 
REORDERL 2N er ae aioe ie. 
QUANDISC 1v¥2 wa eet ae fo 
VENDNAME 260A K2 Pee, ate ants 
VENDADDR 35A ss wales aes ——s5 
. VENDZIP 5N aA wee Ses eho 
Remember, the changes are made only on the session file copy of 
Making changes your structure. To make the changes permanent, you must re-save 
permanent the structure under the same name. 
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6.12. USING COMMANDS TO MANIPULATE YOUR STRUCTURE @ 


STRUCTURE COMMANDS 
menu 


Selection action 


Now that you've entered and changed your structure and are back 
to the STRUCTURE COMMANDS menu (screen 6-7), you can use 
various command choices to manipulate your structure. 


SCREEN 
6-7 






STRUCTURE COMMANDS 


. ENTER STRUCTURE 7. REMOVE STRUCTURE 

- CHANGE STRUCTURE 8. INSERT INTO STRUCTURE 

. SAVE STRUCTURE 9. PRINT STRUCTURE NAMES 

. DESPLAY STRUCTURE 10. HELP - EXPLANATION OF COMMANDS 

. DESPLAY STRUCTURE NAMES 11. HELP - EXPLANATION OF STRUCTURES 
- PRINT STRUCTURE 12. TERMINATE STRUCTURE PROCESSOR 


ENTER SELECTION _ STRUCTURE NAME 


On emwne 


Selection: 
1 Displays the ENTER STRUCTURE screen (6-4) 
2 Displays the CHANGE STRUCTURE screen (6-6) 


3 Saves your structure on a library under a name you 


specify & 


4 Displays your structure on the workstation 


5 Displays a list of all existing structure names on the 
workstation 


6 Prints your structure on the printer 


7 ~~ Lets you remove a structure from either the ESCORT 
library file or the session file 


8 Lets you insert statements into an existing structure 
9 Prints your structure names on the printer 

10 Explains the command choices 

11 Explains what structures are 


12 Lets you return to the command selection menu (screen 
6-2) 


For more detail on choices 1 through 9, see 5.16, STRUCTURE 
COMMANDS. 8 
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© 6.13. THE STRUCTURE HELP FACILITY 


The structure HELP facility is no different from the HELP facility in 

When to use program mode except that it works with structures. When you don't 
understand something on the structure screen menus, just key in 
the selection number for the HELP facility, and a series of screens 
explaining the part you are having trouble with appears. A sample 
structure HELP screen is: 


STRUCTURES ENABLE YOU TO DEFINE BY THE USE OF A STRUCTURE STATEMENT, THE 
INPUT/OUTPUT DATA FILE RECORDS AND THE DATA FIELDS OF THE WORK AREA. EACH 
STRUCTURE STATEMENT DEFINES A FIELD OF A RECORD. THE STRUCTURE STATEMENT MAY 
CONTAIN UP TO SEVEN COMPONENTS: FIELD NAME, FIELD LENGTH, DATA TYPE, MATCHING 
Sample structure OR INDEX KEY IDENTIFICATION, EDIT CODES (TYPE OF EDITING TO BE PERFORMED ON THE 
HELP screen FIELD), REPEAT COUNT (NUMBER OF CONSECUTIVE OCCURRENCES OF THE FIELD IN THE 
RECORD). AND THE POSITION OF THE FIELD WITHIN THE RECORD. EACH FIELD REQUIRES 
THE NAME, LENGTH, AND DATA TYPE, BUT THE OTHER COMPONENTS ARE OPTIONAL. 


NAME - SPECIFIES THE NAME ASSIGNED TO THE FIELD. THE NAME CAN BE FROM 1 to 8 
ALPHANUMERIC CHARACTERS, BUT THE FIRST CHARACTER MUST BE ALPHABETIC. 


LENGTH - SPECIFIES THE LENGTH OF THE FIELD. 
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7. Programs and Program 
Statements 


7.1. WHAT ARE PROGRAM STATEMENTS? 


Program statements 


Use in tutorial mode 


Use in program mode 


Types of program 
statements 


As you recall from Section 1, program statements are combinations 
of ESCORT words that make up different types of ESCORT 
programs. Depending on the type of program statement you use, 
ESCORT performs different operations on your data. 


In tutorial mode, ESCORT asks you questions about what you want 
your program to do and generates program statements based on 
your answers to these questions. 


In program mode, ESCORT helps you create programs by using 
screen menu choices or lets you key in your own programs by 
using the direct entry method. The ESCORT compiler verifies your 
program statements and translates them into executable code. 
Then, when you issue a RUN PROGRAM command, the run-time 
processor executes your program. 


There are five types of program statements: 





CHANGE 
DATA 


DELETE 
DATA 
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Every time you write a program, you use one of these statements. In 
their basic format (without clauses), they describe the general 
Function of program operation you want to perform on your file. In their expanded form 
statements (with clauses), they give more specifics about how you want the 
operation performed. You'll get an idea of how you can be more 
specific with clauses if you look at Table 7-1, which lists the clauses 
and shows which clauses apply to each type of program statement. 


Table 7-1. Program Statement and Clause Cross-reference 


Clauses ENTER CHANGE | SELECT SORT DELETE 
DATA DATA DATA DATA DATA 










ies) 
< 


CLEARING 


COMPUTING 


CREATING 


. 


DISPLAY 


EXIT 


EXTENDING 


OUTPUT TO 
PRINT 
SUBTOTALING 
TOTALING 


UPDATING i 


USING 


WHILE 


m 
2 
Oo 


WORKAREA 


LEGEND 


Applicable 


NOTE: 


The FROM clause does not appear in this table because it is part of the basic 
program statement. 


We'll tell more about the individual clauses in 7.16. But, first, we'll 
look at the formats of program statements and how they work. 
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& 7.2. PROGRAM STATEMENT FORMAT CONVENTIONS 


The conventions used to present program statement formats are: 





Uppercase words A Words in capital letters must be keyed in exactly as shown: 


ENTER DATA FROM WS 


Lowercase words ‘; [aa Lowercase letters and embedded hyphens designate names 
you supply: 
USING input-file-1,...,input-file-n 
Brackets [ ] Optional parameters are enclosed by brackets: 


[IF conditions} 


@ Braces Alternative choices are enclosed by braces. When you specify 
the parameter, you must pick one of the choices: 





structure 
structure,form 
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7.3. ENTER DATA PROGRAM STATEMENT 


Use 


Related clauses 


Other clauses 


Probably one of the most used of the five types of program 
statements is the ENTER DATA program statement. You use this 
statement every time you create a new file or enter data into an 
existing file. 


Clear data fields 
(CLEARING clause) 


Compute arithmetic expressions 
(COMPUTING clause) 


Create a new file 
(CREATING clause) 


Output automatically formatted 
data to the workstation 
(DISPLAY clause) 


Add data to an existing file 
(EXTENDING clause) 





Specify conditions for data entry 
(IF and WHILE clauses) 


Output custom formatted data 
to a workstation or printer 
(OUTPUT TO clause) 


Output automatically formatted 
data to the printer 
(PRINT clause) 


Subtotal and total fields 
(SUBTOTALING and 
TOTALING clauses) 


Allocate working storage 
(WORKAREA clause) 





Other clauses used with the ENTER DATA program statement are: 


a END clause 


a EXIT clause 
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7.4. COMPLETE FORMAT OF THE ENTER DATA PROGRAM STATEMENT 


The format of the ENTER DATA statement and its related clauses 










ES SSS ee 
NTER DATA FROM WS fe | 
structure form 


ce mee 
[dat ent statements ] 
SUBTOTALING fieldnames [‘‘literal expressions’ ’] 


TOTALING fieldnames [‘‘literal expressions’ '} 





Basic format 





IFyconditions,clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 
COMPUTING data replacement statements 
WHILE conditions clauses END 
CLEARING fieldnames 
CREATING output-file [structure] 
EXTENDING output-file [structure] 


PRINT[(fieldnames [‘‘literal expressions’’] 
SUBTOTALS 
TOTALS 
structure 
DISPLAYi(fieldnames [‘‘titeral expressions’ '] 
SUBTOTALS 
TOTALS 
structure 


OUTPUT TOfWS structure 
PRINTERJUstructure,form 


EXIT 
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7.5. BASIC ENTER DATA PROGRAM STATEMENT 


Clauses Because most of the clauses used by the ENTER DATA statement 
are shared by other program statements (see Table 7-1), we'll 
discuss them alphabetically beginning in 7.16. For now, just look at 
the parameters of the basic ENTER DATA statement: 


Format ENTER DATA FROM WS [eee i 
structure, form 


Parameters structure 
Names the structure used for the input data record. 


Parameter uses Use this parameter to name the input structure when you 
input data to certain fields in a master file. To do this, you 
create another structure containing the fields you need to 
input. When your program is executed, enter data into the 
fields you designated in that structure. ESCORT matches these 
field names with the field names in the master file and enters © 
your data accordingly. 





Example Consider the following example: 
Master File Structure Input File Structure 
ACCTMAST | ACCTINIT 


| ACCTNO 
| NAME 
‘| ADDRESS 


_| ACCTNO 

| NAME 

_| ADDRESS 

| city 

| PHONE 
DEPOSIT 


CITY 


Example structures PHONE 
ACCTBAL 
DEPOSIT 
WITHDRAW 
OLDBAL 





For this example, we’ve assumed that a bank will use these 
structures. The file ACCTMAST represents a file containing all 
the bank’s accounts, and the structure ACCTINIT contains the 
fields a clerk needs to enter to start new accounts. This means 
the master file called ACCTMAST contains all the fields in the 
structure ACCTMAST, but with this program, you only enter 
data into the fields specified in ACCTINIT. 








UP-8855 Rev. 1 SPERRY UNIVAC OS/3 7-7 
: ESCORT 





ENTER 
DATA 
STATEMENT 





Example program You write your program like this: 


ENTER DATA FROM WS (ACCTINIT) 


CREATING ACCTMAST 





structure,form 
This enables you to use a customized form for input. Structure 
names the structure that’s linked to the form. (If we used a 


form for our previous example, the structure would be 
ACCTINIT.) 


Form names the form you created to use with the structure. 
For details on forms, see Section 9. 
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7.6. CHANGE DATA PROGRAM STATEMENT 


Use 


Related clauses 


Other clauses 





Use the CHANGE DATA program statement to replace or update 
data records within an existing file. As with the other program 
statements, you use a set of related clauses to perform other 


functions on this data. 


Clear data fields 
(CLEARING clause) 


Compute equations 
(COMPUTING clause) 


Output automatically formatted 
data to the workstation 
(DISPLAY clause) 


Specify conditions for data change 
(IF and WHILE clauses) 


Output custom formatted data 
to the workstation or printer 
(OUTPUT TO clause) 





Output automatically formatted 
data to the printer 
(PRINT clause) 


Subtotal and total fields 
(SUBTOTALING and 
TOTALING clauses) 


Use additional files as input 
(USING clause) 


Allocate working storage 
(WORKAREA clause) @ 








Other clauses used with the CHANGE DATA program statement are: 


a END clause 


a EXIT clause 
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7.7. COMPLETE FORMAT OF THE CHANGE DATA PROGRAM STATEMENT 


The format of the CHANGE DATA statement is: 


Besic format CHANGE DATA OF master-file [structure 


FROM(WS eo } 
structure,form 


el a Leet serer®] 








,input-file-5 [structure]] 
WORKAREA structure [data replacement statements] 
SUBTOTALING fieldnames [‘‘literal expressions’ ’ } 


[usine input-file-1 Pelieetitel: 


TOTALING fieldnames [‘‘literal expressions’ '] 


IFfconditions)clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 
COMPUTING data replacement statements 
WHILE conditions clauses END 
CLEARING fieldnames 
PRINT] (fieldnames [‘‘titeral expressions''} 
SUBTOTALS 
TOTALS 
structure 


DISPLAY|(fieldnames [‘‘literal expressions''] 
SUBTOTALS 
TOTALS 
structure 


OUTPUT TO{WS structure 
PRINTER} (structure, form 


EXIT 
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. STATEMENT 


7.8. BASIC CHANGE DATA PROGRAM STATEMENT 


Clauses Because most of the clauses used by the CHANGE DATA statement 
are shared by other program statements (see Table 7-1), we'll 
discuss them alphabetically beginning in 7.16. For now, just look at 
the parameters of the basic CHANGE DATA statement: 


Format CHANGE DATA OF master-file [structure] 


FROM(WS[ {structure | 
structure, form 


input-file [structure] 


Parameters master-file 
Names the file you want changed. 


structure 
Is included when the name of the structure to be used is not 
the same as the first eight characters of the master-file name. 


ws 
Changes are input from the workstation. 


input-file 
Names input file that contains changed data. 


Parameter usage When you use this parameter, the input file you name is a 
transactional file that contains the records you want to change 
in the master file. When you execute this program, ESCORT 
matches the fields in the transactional file with the fields in 
the master file and puts the contents of the input 
(transactional) file into the master file as changed data. 


structure 
Names structure used for input data record. 


Use this parameter with an input file only if the structure 
name is different from the first eight characters of the input 
file name. 


You can name a structure for workstation input that includes 
only the fields of the master file record you want to change. 
This is helpful because when you make changes you need not 
look at every field in the master file; only the data fields you 
want changed are displayed. 
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CAUTION 


When you use this parameter with 
workstation input, make sure you key 
data into every field that is displayed. 
Fields that have the same name in the 
input and master files are replaced in the 
master file with the input you key in. If 
you don’t key new data into the fields, 
ESCORT transfers them to the master file 
as blanks or zeros, thereby destroying 
your existing master file data. 


structure,form (Used only with WS parameter) 
Names structure and form used to input changes 


This displays your data in the form you specify, and you input 
your changes. 
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7.9. SELECT DATA PROGRAM STATEMENT 


Use 


Related clauses 


Other clauses 


Use the SELECT DATA program statement to extract data from an 
existing file. As in the other program statements, use a set of 
related clauses to perform other functions on this data. 


Clear data fields 
(CLEARING clause) 


Compute arithmetic expressions 
(COMPUTING clause) 


Create a new file from selected 
records in an existing file 
(CREATING clause) 


Output automatically formatted 
data to the workstation 
(DISPLAY clause) 


Add selected data to an 
existing file 
(EXTENDING clause) 


Specify conditions for 
data selection 
(IF and WHILE clauses) 





Output custom formatted data 
to the workstation or printer 
(OUTPUT TO clause) 


Output automatically formatted 
data to the printer 
(PRINT clause) 


Subtotal and total fields 
(SUBTOTALING and 
TOTALING clauses) 


Update records in a file 
(UPDATING clause) 


Use additional files as input 
(USING clause) 


Allocate working storage 
(WORKAREA clause) 





Other clauses used with the SELECT DATA program statement are: 


a END clause 


a EXIT clause 
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7.10. COMPLETE FORMAT OF THE SELECT DATA PROGRAM STATEMENT 


The format of the SELECT DATA statement and its related clauses 
is: 








Basic format 


FROMUWS | {structure 
structure,form 
input-file [structure] 
fu SING 


input-file-1 [structure],...,input-file-5 [structure]] 
WORKAREA structure [data replacement statements] 





SUBTOTALING fieldnames [‘‘literal expressions’ ' ] 
TOTALING fieldnames [‘‘literal expressions’ '] 
IFf(conditions)clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 
COMPUTING data replacement statements 
@ WHILE conditions clauses END 
CLEARING fieldnames 
CREATING output-file [structure] 
EXTENDING output-file [structure] 
UPDATING input-file 
OUTPUT Ie ade } 
PRINTERJP (structure, form 
PRINTU(fieldnames [‘'literal expressions’ ' ] 
SUBTOTALS 
TOTALS 
structure 
DISPLAY] ffieldnames [‘'‘literal expressions''’ ] 
SUBTOTALS 
TOTALS 
structure 
EXIT 
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7.11. BASIC SELECT DATA PROGRAM STATEMENT 





Clauses Because most of the other clauses used by the SELECT DATA 
statement are shared by other program statements (see Table 7-1), 
we'll discuss them alphabetically beginning in 7.16. For now, just 
look at the parameters of the basic SELECT DATA statement. 


Format SELECT DATA OF master-file [structure] 


FROMEWS| (structure 
structure,form 


input-file [structure] 


Parameters master-file 
Names the data file you're selecting. 


structure 
Is included when the name of the structure to be used is not 
the same as the first eight characters of the master-file name. 





ws 
You key in data selection criteria from the workstation. 


input-file 
Names the file containing the selection criteria. 


structure 
Names the structure used for the input data record. 


Use this parameter only if the structure name is different from 
the first eight characters of the input file name. 


structure, form (Used with WS parameter only) 
Names the structure and form used for the workstation. This <_ 
displays your data in the form you specify. 
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7.12. SORT DATA PROGRAM STATEMENT 


Uses Use the SORT DATA program statement to sort a data file by field 
names or a sort key and create a new sorted file. 





Clause restrictions Whereas other program statements use many clauses, the 
CREATING and BY clauses are the only ones you're permitted to 
use with the basic SORT DATA statement. Because these clauses 
are the only ones used, they are shown as part of the basic SORT 
DATA statement. A description of the CREATING clause appears in 


7.20. 
Sort field The maximum total length of the fields used to determine the 
restriction sequence of the records in the output file is 80 bytes. 


Information on the sequencing of the records in the output file is 
given in Appendix D. 





7.13. FORMAT OF THE SORT DATA PROGRAM STATEMENT 
The format of the SORT DATA statement is: 


Format SORT DATA OF master-file [structure] 
[BY field-1,..., field-6] 
CREATING output-file [structure] 


Parameters master-file 
Names the file you want sorted. 


structure 
This parameter is required only if the name of the structure is 
different from the first eight characters of the master-file 
name. 


BY field-1,..., field-6 
Names the fields in the master-file structure that you want to 
use to sort your file. 


The order in which you list these fields determines the order 
of the sort (e.g., your data is sorted according to the first field 
you specify, then the second, etc). For an example of the use 
of the BY clause, see 4.20. 
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STATEMENT 


CREATING output-file | 
Names the file to be created as a result of the sort. 


This must be a file other than the master-file. 


structure 
This parameter is required only if the name of the structure is 
different from the first eight characters of the output-file 
name. 


If you do not include the BY clause, you must use a structure 
for the output file that has one field specified as an MS 
(matching sorted) data field. Otherwise, you get an error. For 
an example of this method of sorting data, see 4.21. 
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& 7.14. DELETE DATA PROGRAM STATEMENT 


Uses Use the DELETE DATA program statement to logically remove data 
records from a file. 





Whereas other program statements use many clauses, the IF 
clause is the only clause you're permitted to use with the basic 
DELETE DATA statement. Because IF is the only clause used, it is 
shown as part of the basic DELETE DATA statement. No END 
clause is included in the DELETE DATA program statement. 





7.15. FORMAT OF THE DELETE DATA PROGRAM STATEMENT 


The format of the DELETE DATA statement is: 


Format DELETE DATA OF master-file [structure] 


FROM oe | nee 
© structure,form 


input-file[structure] 


IF conditions 


Parameters master-file 
Names the file from which you want records deleted. 


structure 
Use this parameter only when the name of the structure you 
use is not the same as the first eight characters of the master- 
file name. . ; 


“FROM WS 2 4 
Enter matching criteria for record deletion from the 
workstatjon. za : : , 
FROM Cie file , ; 

‘Names the file containing the Pomerening criteria for record : 


deletion. 


’ oy 
i i 8, ' 


structure ' 
! Names the structure used for jap data records. 


' Use this parameter Sale if the structure name is different from. 
& ' the first eight characters of the input file name. 
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= STATEMENT 


structure, form (Used with WS parameter only) 
Names structure and form used to enter input records. 


IF conditions 
Criteria that must be satisfied for deletion to occur. 
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7.16. CLAUSES USED WITH PROGRAM STATEMENTS 


Function of clauses 


How to find clauses 


While ESCORT program statements describe the general 
operations to perform, ESCORT clauses describe the specific ones. 


There are 17 ESCORT clauses, and though some apply exclusively 
to one program statement type, many are shared by more than 
one. 


For ease of reference, clauses are presented in alphabetical order. 


a Look up the clause you want to use. 






| Check the chart at the top of the clause description to see if 
| the clause applies to the program statement you're using. The 
unshaded blocks show the program statements the clause is 
used with. 


cs If the clause applies, read the description and examples. 


If it doesn’t, check the format for the program statement 
you're using and select another clause. 
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BY CLAUSE 





7.17. HOW TO DESIGNATE SORT FIELDS (BY CLAUSE) 


Use Use the BY clause exclusively with the SORT DATA program 
statement to designate the fields you want your data sorted by. 


The format is: 
Format BY field-1,..., field-6 


Parameters field-1,..., field-6 


Names the fields you use to sort your files. 


The order in which you list the fields determines the order of 
the sort. 
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CLEARING CLAUSE 


ENTER CHANGE SELECT 
DATA DATA DATA 





7.18. HOW TO CLEAR DATA FIELDS (CLEARING CLAUSE) 
Use — _ Use this clause to clear data fields you specify. 
The format is: 


Format CLEARING fieldnames 


Parameters fieldnames 
Names the fields you want cleared. 


Example: clearing Alphanumeric fields are cleared to blanks. 
alphanumeric fields 

NAME 

CITY 


Example: clearing numeric, Numeric, decimal, packed, and binary fields are zero filled. 
decimal, packed, and 


binary fields ZIPCODE 99098 


BALANCE 88996 .08 
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COMPUTING CLAUSE 





ENTER CHANGE SELECT 
DATA DATA DATA 


7.19. HOW TO CALCULATE EXPRESSIONS AND 
STORE THE RESULTS (COMPUTING CLAUSE) 


Use Use this clause to calculate expressions and store the results. 
The format is: 


Format COMPUTING data replacement statements 


Parameters data replacement statements 
Specify arithmetic expressions to be completed or data 
movement to be performed. 


Example: data replacement Examples of the two types of data replacement statements are: 
statements 


] Arithmetic 


Computes values of one or more fields to result in a single 
value for another field. 


COMPUTING BALANCE=DEPOS1TS+OLDBAL-WI THDRAW 
or 
COMPUTING TOTPAY=HOURS* RATE 


a Data Movement 


Moves the result of a computation of one or more fields into 
another field. 


COMPUTING FLDA=FLDB 


or 


COMPUTING FLDA=‘‘ABC’' 
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CREATING CLAUSE 





SELECT SORT 
DATA DATA : 


7.20. HOW TO CREATE A NEW DATA FILE 
(CREATING CLAUSE) 


Use Use this clause to create a new data file. This file can contain new 
data or the results of a SELECT or SORT operation. 


The format is: 


Format CREATING output-file [structure] 


Parameters output-file 
Names the file you're creating. 


File name attributes File names are 1 to 44 characters long and are specified in 
either of two ways: 


= Only letters (A-Z), numbers (0-9), and the characters 
slash (/) and period (.) may be used in ESCORT file 
names. The first character must be a letter, and 
embedded blanks are not allowed. 


Example: 


XYZCO/PAYABLES.TAXES 


a = When you enclose the file name in double quotes ("’), any 
character except a single quote (’) or a double quote may 
be included, and embedded blanks are allowed. 


Example: 


“"TNVENTORY MASTER FILE’ ’ 


structure 
Names the structure for the file you‘re creating. 


Structure name A structure name may be from one to eight characters long. It 
attributes must begin with a letter (A-Z) and contain only letters and 
numbers (0-9). 
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' 


If your structure name is the same as your file name or as the & 
first eight characters of your file name, you don’t need to use 

this parameter. Otherwise, you must include, in parentheses, 

the name of the structure you want to use with your file. 





Examples: 


CREATING XYZFILE 
CREATING ‘‘#4INVENTORY FILE’’ (INVNTORY) 
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& DISPLAY CLAUSE 


ENTER CHANGE SELECT 
DATA DATA DATA 





7.21. HOW TO DISPLAY DATA ON THE WORKSTATION 
(DISPLAY CLAUSE) 


Use Use this clause to output data on the workstation, using automatic 
formatting. 


The format is: 


Format DISPLAY{ /fieldnames [‘‘literal expressions’ ] 
SUBTOTALS 
TOTALS 
structure 


Parameters fieldnames 


Specifies data field names you want displayed as part of your 
output. 


& fiteral expressions (Used only with fieldnames parameter) 
Specifies literal expressions you want displayed as part of your 
output. 


SUBTOTALS 
Displays automatically formatted subtotaling data. After data is 
displayed, SUBTOTALING fields are reset to zero values. 


TOTALS 
Displays automatically formatted totaling data. 


structure 
Names structure containing data field names for the data you 
want displayed. 
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END CLAUSE 






ENTER CHANGE SELECT 
DATA DATA DATA 


7.22. HOW TO ENCLOSE CONDITIONALS 
(END CLAUSE) 


Use Use this clause as a sentinel to enclose the clauses affected by an 
IF or WHILE conditional clause. 


The format is: 


Format END 
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EXIT CLAUSE 


ENTER CHANGE SELECT 
DATA DATA DATA 





7.23. HOW TO SPECIFY EARLY TERMINATION OF A PROGRAM 
(EXIT CLAUSE) 


Use Use this clause to terminate execution of your program in an 
orderly manner before reaching the end of your input file. You 
usually use this clause to terminate following a conditional IF or 
WHILE clause. That way, when conditions are satisfied before the 
end of your file is reached, you can halt processing, saving time. 


The format is: 


Format EXIT 
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EXTENDING CLAUSE 


ENTER SELECT 
DATA DATA 






7.24. HOW TO ADD RECORDS TO AN EXISTING DATA FILE 
(EXTENDING CLAUSE) 


Use Use this clause to add records to an existing data file. 
The format is: 


Format EXTENDING output-file [structure] 


Parameters output-file 
Names file you're adding to. 


structure 
Names output structure you're using. 


This parameter is not required if your structure name is the 





same as the first eight characters of your file name. <_ 
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IF CLAUSE 








7.25. HOW TO SPECIFY CONDITIONS FOR PROCESSING 
(IF CLAUSE) 


Use Use this clause to specify conditions that determine whether to 
process the clauses that follow. A list of conditions that you can 
use with this clause appears in 7.34. 


The format is: 


Format IF(conditions\clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 

Parameters conditions 


Statements you specify that must be satisfied before the 
clauses that follow are executed. 


Examples For example, consider the following programs: 


Program 1: 


ENTER DATA FROM WS 
IF FIELDI=5 
CREATING NEWFILE END 


Program 2: 


SELECT DATA OF FILEONE 
IF BALANCE >5898 
OUTPUT TO PRINTER (strucl,form) END 


In program 1, the data you enter is only placed in NEWFILE if 
the value of FIELD1 equals 5. 


In program 2, the data you retrieve is output only if the field 
named BALANCE contains a value greater than 500. 
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NOTE: 


The next two parameters are used only with the IF clause and are 
called special system operators. 


FIRSTIME 


The clauses you specify to be executed (dependent on the IF 
clause) are executed once after you enter your initial input but 
before any processing begins (e.g., a title appearing at the top 
of a report). 


ENDOFILE 


Specifies that when the end of the input file is reached, the 
clauses you specify are executed once. 


ENTER DATA FROM WS 
Example EXTENDING FILE1 —_— 
TOTALING FIELD1 
IF ENDOFILE 
PRINT TOTALS END 


clauses 
Clauses to be executed, depending on the conditions, 
FIRSTIME, or ENDOFILE parameter. @ 


ELSE clauses 


Clauses to be executed if the clauses specified in the 
conditions, FIRSTIME, or ENDOFILE parameter are not. 


END 


Encloses clauses dependent on the conditions, FIRSTIME, or 
ENDOFILE parameters. For more on the END clause, see 7.22. 
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OUTPUT TO CLAUSE 





ENTER CHANGE SELECT 
DATA DATA DATA 


7.26. HOW TO OUTPUT YOUR DATA IN A UNIQUE FORMAT 
(OUTPUT TO CLAUSE) 


Use Use this clause to output your data records to the workstation or 
printer, using a format you supply. This format can be either a 
structure or a structure and a form you create, using the screen 
format generator. 


The format is: 


Format OUTPUT TOIWS | eracaenad 
PRINTER) Istructure,form 
Parameters WSs 
Displays formatted output on the workstation. 
PRINTER 


Prints formatted output on the printer. When you output a 
print form, you are limited to 80 printer positions. 


Structure 
The structure by which output is formatted. 


structure,form 
Names the structure and form you use for output. 


This parameter displays your data, record by record, in the 
screen format (form) you designate. 
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PRINT CLAUSE 








7.27. HOW TO OUTPUT YOUR DATA TO THE PRINTER, 
USING AUTOMATIC FORMATTING (PRINT CLAUSE) 


Use Use this clause to output your data on the printer, using automatic 
formatting. 


When you use this statement, your data is printed one of two 
ways: 


1. If your record is short enough, ESCORT prints the fieldnames 
as column headings with the data records listed underneath. 


2. If your record is long, ESCORT prints each field name and its 
data alongside it. See the printout examples in Section 4. 





Format The format is: 
PRINTi(fieldnames [‘‘literal expressions’ ' ] 
SUBTOTALS 
TOTALS 
structure 
Parameters fieldnames 


Data field names you want printed as part of your output. 


literal expressions (Used only with fieldnames parameter) 
Literal expressions you want printed as part of your output. 


SUBTOTALS 
Prints automatically formatted subtotaling data. 


After data is listed, the SUBTOTALING fields are reset to zero 
values. 


TOTALS 
Prints automatically formatted totaling data. 


structure 
Names the structure containing the data field names for the 
data you want listed. 
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SUBTOTALING CLAUSE 





ENTER CHANGE SELECT 
DATA DATA DATA 


7.28. HOW TO ACCUMULATE SUBTOTALS FOR YOUR FIELDS 
(SUBTOTALING CLAUSE) 


Use 


Format 


Parameters 


Example structures 


Use the SUBTOTALING clause to accumulate totals for the data 
fields you specify so you can output them on the workstation or 
printer. To get subtotals at the end of each page (24 lines for 
workstation, approximately 55 for printer), you must specify the IF 
conditions clause and specify a line counter variable (we used 
LINECNT=55) or ENDOFILE condition. Then the SUBTOTALING 
data fields are reset to zero values, and the accumulation can 
begin for the next page. 


NOTE: 

This clause only performs the SUBTOTALING operation. To receive 
SUBTOTALING output, you must specify the SUBTOTALS 
parameter of the PRINT clause. 


The format is: 


SUBTOTALING fieldnames [‘‘literal expressions’'} 


fieldnames 
Names the fields you want subtotaled. 


literal expressions 
Text you specify that is displayed as part of the SUBTOTALING 
line. 


Consider the following example: 


STRUCTURE OF MYFILE STRUCTURE OF WORKAREA (WORK1) 





t 


t 
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7-34 


SC 


To get SUBTOTALING printed at the bottom of each page, you 


use the following program: 


PROGRAM 


SELECT DATA OF MYFILE 
WORKAREA (WORK1) LINECNT=1 
SUBTOTALING ‘‘SUBTOTAL'’'’,FIELDA,FIELDB 
IF LINECNT<55 

PRINT FIELDA,FIELDB END 

IF LINECNT=55 

PRINT SUBTOTALS 

COMPUTING LINECNT=0 END 
COMPUTING LINECNT=LINECNT+1 
IF ENDOFILE 

PRINT SUBTOTALS END 


This produces output of: 


ESCORT DATA LISTING 
FIELDA FIELOB 
5 18 
18 
18 
9 


SUBTOTAL 


OOODD000000 





EXPLANATION 


Simple select data 

Designate work area 
Subtotaling function 
Conditional 

Action if line 4 is true 
Conditional 

Action if line 6 is true 
Resets LINECNT variable to O 
Counter using work area field 
When end of file is reached 
Perform this operation 


Line 1 


Line 55 or ENDOFILE 


O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
O 
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TOTALING CLAUSE 





ENTER CHANGE SELECT 
DATA DATA DATA 


7.29. HOW TO ACCUMULATE A RUNNING TOTAL 
(TOTALING CLAUSE) 


Use Use this clause to accumulate running totals for the data fields you 
specify so you can output them on the workstation or printer. 


The format is: 


Format TOTALING fieldnames [‘‘literal expressions''] 


Parameters fieldnames 
Names the fields you want totaled. 


literal expressions 
Text you specify that is displayed as part of the TOTALING 
line. 
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UPDATING CLAUSE 





7.30. HOW TO UPDATE RECORDS IN A FILE 
(UPDATING CLAUSE) 


Use Use this clause to update records in an existing file. 
The format is: 


Format UPDATING input-file <{— 


Parameters input-file 
Names the file in which records are to be updated. 


The file named must be the master file or one of the input 
files used in the program. 
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USING CLAUSE 





CHANGE SELECT 
DATA DATA 


7.31. HOW TO SPECIFY ADDITIONAL FILES 
(USING CLAUSE) 

Use Use this clause to specify additional file names when you need to 
reference fields not contained in the files named in the basic 
statements. When you use this clause, it’s considered part of the 
basic program statement and must be placed directly after it. 

The format is: 
Format [USING input-file-l[structure],...,input-file-5[structure]] 
Parameters input-file-1,..., input-file-5 


Names up to five additional input files. 


For an example of the USING clause, see 4.14. 
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ENTER CHANGE SELECT 
DATA DATA DATA 


7.32. HOW TO SPECIFY CONDITIONS FOR PROCESSING 
(WHILE CLAUSE) 


Use 


Format 


Parameters 


Example 


Use this clause to apply conditions that, while satisfied, cause the 
execution of the group of clauses that follow. 


The format is: 


WHILE conditions clauses END 


conditions 


Statements you specify that determine whether the clauses 
that follow are executed. 


An example of the conditional WHILE is: 


ENTER DATA FROM WS 

WHILE PRINC<28908 @ 
COMPUTING INT=PRINC*RATE 

PRINT PRINC,RATE, INT 

COMPUTING PRINC=1909+PRINC 

END 





This means that while the field PRINC is less than 20000, the 
computations are performed and the principal, rate, and 
interest are printed. 


clauses 
Clauses that are executed while conditions are satisfied. 


In the preceding example, COMPUTING and PRINT were the 
clauses executed. 


END 


A sentinel to enclose the clauses affected by the WHILE 
conditions. 
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WORKAREA CLAUSE 





ENTER CHANGE SELECT 
DATA DATA DATA 


7.33. HOW TO ALLOCATE WORKING STORAGE 
(WORKAREA CLAUSE) 


Use Use the WORKAREA clause to allocate temporary working storage 
space and initialize values of data fields not defined in input or 
output structures. 


The format is: 


Format WORKAREA structure [data replacement statements ] 


Parameters structure 


Names the structure containing data field names for working 
storage area. 


data replacement statements 


Initialize fields in the named structure to values other than 
zeros or blanks. 


For an example of WORKAREA, see Figure 4-1. 








UP-8855 Rev. 1 





SPERRY UNIVAC 0S/3 7-40 
ESCORT 


7.34. CONDITIONS AND SPECIAL OPERATORS USED WITH THE 
IF AND WHILE CLAUSES 


Types of operators When you use the IF and WHILE clauses, there are four types of 
operators you can use to specify conditions: relational operators, 
special character string operators, logical operators, and special 
system operators. 


Use 





EQ 


NE 
GT 
LT 


GE 


LE 


Use 


STARTS WITH ‘‘string’’ 





Relational Operators 


Relational operators specify types of conditions you specify 
that regulate the entry, modification, or selection of your data. 
These conditions can be specified in either alphabetic or 


symbolic form: 


= Equal to IF FIELDA=FIELDB+FIELDC 
<> Not equal to IF FIELD1< >FIELD6 
> Greater than WHILE CRLUMIT GT 500 
< Less than WHILE ACCTBAL LT 1000 
>= Greater than or IF COUNT GE 24 

equal to 
<= Less than or equal to IF AGE LE 30 


Special Character String Operators 


Special character string operators let you set conditions on 
alphanumeric fields by specifying a character string 
designation. The six string operators are: 





ENDS WITH ‘‘string’’* 


CONTAINS ‘“‘string”’ 


DOES NOT START WITH “‘string”’ 


DOES NOT END WITH ‘‘string’’* 


DOES NOT CONTAIN ‘‘string”’ 









IF ACCTNO STARTS WITH “A21 





IF PRODESC ENDS WITH “COAT” 


WHILE PRODESC CONTAINS “CHOCOLATE” 


IF ADDRESS DOES NOT START WITH “194” 


IF PRODCODE DOES NOT END WITH “DIS” 





IF DESC DOES NOT CONTAIN “RED” 


*These two character string operators look only at the last positions of a field, not the last 
characters of data entered. Thus, if you use these characters on a field that is not full (i.e., 
five characters entered into an 8-character field) ESCORT checks only the last positions. 
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@ = Logical Operators 


Logical operators There are two logical operators, OR and AND, that you can 
use to connect one or more conditional expressions. Examples 
of these logical operators are: 


Example 1: IF FIELDA>FIELDB OR FIELDA>23 
Example 2: tf (FLDA=‘'‘36'’ AND FLDC=FLDE) OR FLDF=22 


= Special System Operators (IF clause only) 


The special system operators include FIRSTIME and 
ENDOFILE. 


FIRSTIME operator FIRSTIME executes clauses you specify only once after you 
enter your initial input but before any processing begins (e.g., ~~ 
a title appearing at the top of a report). 


ENDOFILE operator ENDOFILE specifies that once the end of the input file is 
reached, the clauses you specify are executed once. 
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8. Jobs 


8.1. WHAT IS A JOB? 


Job definition 


Difference between job 
and program 


Ways to use a job 


Advantages of jobs 


An ESCORT job is a group of related programs that are executed 
sequentially. You designate these programs and their order of 
execution when you enter your job. An ESCORT job is not the 
same as an OS/3 job. 


A job is different from a program because you can only execute 
one program at a time, whereas in a job, you can execute up to 
eight programs in sequence. 


For example, you might have the following functions (programs) 
you want to perform on a certain data file: 


1. Enter data into a transactional file 

2. Sort the data in that transactional file 

3. Update the master file with data from the transactional file 
4. Output the data of the updated master file 

If you don’t designate a job, you have to execute each of these 
programs individually, using the RUN PROGRAM command four 
times. 

With a job, you simply list the names of the programs on the 
ENTER JOB screen (screen 8-3), and ESCORT executes them 


sequentially. 


This section tells you how to enter and change your job and how to 
use other ESCORT commands to manipulate it. 
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8.2. HOW TO ENTER A JOB 





Now that you're familiar with jobs, you're ready to enter your own. 


As with all functions of program mode, the first screen that 
appears is the command selection menu (screen 8-1): 


SCREEN 
8-1 





aaa SELECT ONE OF THE FOLLOWING FUNCTIONS ****"* 


1. TERMINATE CURRENT ESCORT SESSION 

TUTORIAL MODE OF OPERATION 

STRUCTURE COMMANDS 

PROGRAM COMMANDS 

- JOB COMMANDS 

. PASSWORD COMMANDS << 


SELECTION 


Command selection 
menu 


One wn 





Since you want to enter a job, choose number 5, JOB 
COMMANDS. Screen 8-2 then appears: 


. Bieta =—se—ees—“‘(C CC 
8-2 


JOB COMMANDS 









ae 1. ENTER JOB 7. REMOVE JOB FROM WORKFILE 
: 2. RUN JOB 8. REMOVE JOB FROM LIBRARY 
JOB COMMANDS 2 3. CHANGE JOB 9. DISPLAY JOB NAMES 
menu . 4. DISPLAY J08 10. PRINT JOB NAMES 
= 5. PRINT JOB 11. HELP - EXPLANATION OF ABOVE COMMANDS 
a 6. SAVE JOB 12. TERMINATE JOB COMMAND SELECTION 
. SELECT COMMAND —_ JOBNAME 
— A 
Now you pick the operation you want. Since you want to enter a 
job, pick number 1, ENTER JOB, and name your job. Assume you 
name your job PAYROLL. Now the ENTER JOB screen (screen 8-3) 
appears, and you key in one to eight program names to form a job. 
Mm SCREEN 
8-3 
ENTER JOB PAYROLL 
KEYIN PROGRAM NAMES IN ORDER OF EXECUTION FOR THIS JOB 
PROGRAM-1 
ENTER JOB PROGRAM-2 
screen PROGRAM-3 
PROGRAM-4 === 
PROGRAM-5 = 
PROGRAM-6 
PROGRAM-7 


PROGRAM-8 
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When you key in the program names you need for your job (we'll 
use the four programs mentioned in 8.1), your ENTER JOB screen 
(screen 8-4) looks like this: 


SCREEN F 
8-4 
ENTER JOB PAYROLL 


KEYIN PROGRAM NAMES IN ORDER OF EXECUTION FOR THIS JOB 
PROGRAM-1 [ae Dragy 
PROGRAM-2 SUD a EY 
PROGRAM-3 Sb) Piaa! 
PROGRAM-4 SRE Agr aes 
PROGRAM-5 
PROGRAM-6 
PROGRAM-7 
PROGRAM-8 





Completed 
ENTER JOB screen 








Processing your job To process your job, press the XMIT key. The JOB COMMANDS 
menu (screen 8-2) then reappears so you can perform your desired 
processing. 


In the next subsection (8.3), we'll discuss the CHANGE JOB 
command, and then we'll move on to the other command options 
available when processing your job (8.4). 


8.3. HOW TO CHANGE A JOB 
To change a job, pick choice 3, CHANGE JOB, from the JOB 


COMMANDS menu (screen 8-2). Screen 8-5 then appears, and 
you make your changes. 


SCREEN = 
8-5 





CHANGE JOB PAYROLL 

PROGRAM-1 ENTRDATA 

PROGRAM-2 SORDATA 

PROGRAM-3 UPDMASTR 

CHANGE JOB PROGRAM-4 OTPTDATA 

screen PROGRAM-5 = 
PROGRAM-6 
PROGRAM-7 


PROGRAM-8 
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Remember, the changes are made only on the session file copy of 


Making changes your job. 


To make the changes permanent, you must resave the 


permanent job under the same name. 


If you need a review on changing a job, see the CHANGE JOB 
command (5.21). 


8.4. USING COMMANDS TO MANIPULATE A JOB 


Now that you've entered and changed your job and you're back to 


the JOB 


COMMANDS menu (screen 8-6), you can use various 


command choices to manipulate your job. 


JOB COMMANDS 
menu 





ME SCREEN 
hae 


1 
2 
3 
4. 
5 
6 





J08 COMMANDS 
. ENTER JOB 7. REMOVE JOB FROM WORKFILE 
. RUN JOB 8. REMOVE JOB FROM LIBRARY 
. CHANGE JOB 9. DISPLAY JOB NAMES 


DISPLAY JOB 10. PRINT JOB NAMES 


. PRINT JOB 11. HELP - EXPLANATION OF ABOVE COMMANDS 
. SAVE JOB 12. TERMINATE JOB COMMAND SELECTION 


SELECT COMMAND __ JOB NAME 


Command initiated action Selection: 


Selection action 5 


10 
11 


12 


Displays the ENTER JOB screen (8-3) 

Executes your job 

Displays the CHANGE JOB screen (8-5) 

Displays your job on the workstation 

Prints your job on the printer 

Saves your job in a library under a name you specify 
Removes your job from the session file (workfile) 
Removes your job from the ESCORT library 


Displays a list of all existing job names on the 
workstation 


Prints a listing of all existing job names on the printer 
Explains the command choices 


Lets you return to the command selection menu (screen 
8-1). 


For details on choices 1 through 12, see 5.24 through 5.34. 
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9. How to Create Customized 
Input/Output Forms 


9.1. WHAT IS A FORM? 


Concept of forms 


Screen forms 


Screen format services 
functions 


Using input screen forms 





We're all familiar with the concept of a form on paper; in fact, we 
use forms every day. Whether it be a check, an employment 
application, a tax form or whatever, we use forms because they are 
an efficient way of standardizing large amounts of data into 
readable reports. 


The forms you use with ESCORT are not paper forms; they're 
screen forms, and they operate under the OS/3 screen format 
services component, which is completely external to ESCORT. 


Screen format services lets you create customized forms on your 
workstation screen and use them to: 


= §=Input data to a program 
= Display output data from a program (on workstation or printer) 
a Input and output data to or from a program 


Using a screen form to input data is fast and easy because it 
employs a fill-in-the-blanks approach. 


oon cals 
a SCRE 





VOTER'S REGISTRATION 


Saeed 
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Using output screen forms When you use a screen form for output, the program you link to 
‘the form automatically fills the blanks with data. 


SCREEN 
9-2 


ACCOUNT STATUS REPORT 
ACCOUNT NO:1827841 DATE:81/83/79 
CREDIT:375.08 
OEFICIT: 250.08 BALANCE: 125.98 


Purpose of section This section broadly describes the concept of creating input/output 
forms and gives an overview of how screen format services works 
with ESCORT. It does not go into the specifics of actually creating a 
form because the process is too lengthy to present in this manual. 


For your reference For specific information on creating and manipulating forms, refer 
to the screen format services concepts and facilities manual. 


9.2. HOW SCREEN FORMAT SERVICES LETS YOU CREATE YOUR FORM 


Elements of screen format Screen format services consists of the screen format generator and 
services the screen format coordinator. 


. Screen Format Generator 


This component allows you to create (generate) screen formats 
from the workstation. 


Function During generation, you specify the form layout, and the screen 
format generator automatically stores the completed form in 
the system library (SYSFMT). The screen format generator also 
makes these forms readily available for you to modify, delete, 
or review. 


= Screen Format Coordinator 


This component coordinates the transfer of input and output 

Accessing screen forms data between your program and the form displayed on the 
workstation screen. The screen format coordinator is activated 
when you call an existing form in your program. It retrieves 
the form from the SYSFMT library and displays it on the 
workstation so you can begin your input or view your 
program's output. 
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@ 9.3. HOW TO CALL THE SCREEN FORMAT GENERATOR 


Before entering ESCORT 





Although we are not discussing the forms entry procedure in this 
manual, you may want to call the screen format generator to 
familiarize yourself with it and perhaps experiment with a form on 
your own. 


The procedure for calling the screen format generator before you 
enter ESCORT is simple. Once you've logged on the system: 


1. Key in the interactive services command: 
RV SFGEN 
2. Press the XMIT key. 


Now you have activated the screen format generator home screen. 


First, this screen appears: 


FUNCTION (1) 1 CREATE 2 CREATE-FROM 3 MODIFY 4 DELETE 

5 SHOW 6 LIST 7 SPOOL 8 TERMINATE 
OLD FORMAT NAME ( ) 1S ON THE FOLLOWING LIBRARY: 
FILE NAME: ($YSFMT )VOLUME: (RES ) 


NEW FORMAT NAME ( )1S TO BE STORED ON THE FOLLOWING LIBRARY: 

FILE NAME: ($YSFMT )VOLUME: (RES ) 

(F THES FILE DOES NOT EXIST, ALLOCATE (2) CYLINDERS. INCREMENT IS (1) CYL. 

"FUNCTION KEYS ARE: F1-GO TO HOME SCREEN, F5-BREAKPOINT SPOOL FILE, F13-HELP, 
F14-EXIT HELP, F20-RESTORE SCREEN 





Then, this screen appears: 





GLOBAL CHARACTERISTICS FOR FORMAT 


LOWER CASE TRANSLATION? (1): 1 YES 2 NO 


ALPHABET: (XXXXXXXX) SCREEN FORMAT !S (1): 1 ORIGINAL 2 OVERLAY 
ERASE/UNLOCK OPTION (1): 1 NONE 2 REPLENISH SCREEN 3 ERASE SCREEN 
A 4 UNLOCK KEYBOARD 5 CONDITIONAL INDICATOR IN USER PROGRAM 
. ERROR RETRY COUNT: (2_) SPECIAL EDITING CHARACTERS? (9): 1 NO 2 YES 
SPECIAL DISPLAY CONTROL? (1): 1 NO 2 YES 
DO YOU WISH TO SPECIFY AN ERROR MESSAGE FIELD? (1) 1 NO 2 YES 
DISPLAY RETENTION ON ALL FIELDS? (1): 1 NO 2 YES 
a FUNCTION OR COMMAND KEYS TO BE DEFINED? (1) 1 NO 2 YES 
a DOES THIS FORMAT HAVE A NON-DISPLAYED CONSTANT? (1): 1 NO 2 YES 


ee 


sth 


x 


By answering the questions on these screens, you select your 
functions and provide data about the form you're creating. 


When you're already in ESCORT and you want to create a form, 
you exit from ESCORT and, when you're back in the system, per- 
form the same steps listed above. 
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9.4. HOW TO LINK YOUR ESCORT PROGRAM TO A SCREEN FORM 


Default screen format 


Customized screen format 


Rules for screen forms 


When you create any ESCORT file, you create a structure for it, 
and the file is built in accordance with this structure. 


When you designate a structure and don't designate a form, you 
have no choice about how your screen is formatted. ESCORT 
displays your fields according to the default screen format, which 
outputs your fields, each on a separate line, in the least possible 
amount of space (see 9.5). 


When you create a form, you give ESCORT a special format in 
which to output the file data. You still designate a structure, but 
instead of your file being output in the default structure format, it’s 
linked with your screen form. 


You can use either the screen format generator or custom 
structures to produce custom formats. Custom structures format 
output according to your specifications. You determine the 
placement of data on the page, including line spacing and page 
breaks. Appendix G gives an example of custom formatting using 
structures. 


When you designate a screen form, the fields you link to it must be 
identical to the fields contained in a structure. They must have the 
same name, and they must be in the same order as the 
corresponding fields in your structure. Both the form and your 
structure must also have the same number of fields. 


For example, if you designate 10 fields in a form and link it to a 
structure with only 9 fields, you get an error because ESCORT 
keeps looking for the tenth field. 


It is possible, however, to have a structure with 10 fields and an 
output form using only 5 fields, but only the first 5 fields of your 
structure are output. Although you can do it this way, it’s always 
better to have a direct structure/form linkup to eliminate confu- 
sion. 
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9.5. EXAMPLE OF ESCORT STRUCTURE/FORM LINKUP 


Example structure 


Default screen format for 
example structure 


Example form 





Let’s assume we have the following structure (named SHIPFILE) for 
a shipping file: 


STRUCTURE OF SHIPFILE 


CARRIER 
| APPRVBY 





When this structure is output in the standard default screen for- 
mat, it looks like this: 


CUS TNAME 
CUSTADDR 


MDSEDESC 
QUANT 
SHIPDATE 
CARRIER 
APPRVBY 





Let’s create a form (named SHIPFORM) to link with this structure 
and you'll see how things change: 


SHIPPING FORM 
INVOICE NUMBER INVOICE DATE 
CUSTOMER NAME 


APPROVED BY ___ 
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Now let’s show how you'd designate this in a program. Since it’s a 
shipping form, let’s use it for input with an ENTER DATA program. 
To enter data onto this form into a file called SHIPFILE, your 
program reads: 


ENTER DATA FROM WS (SHIPFILE, SHIPFORM) 


CREATING SHIPFILE 





When you execute the program, your form (SHIPFORM) then 
appears and you key in your data. 


For more on screen formatting and the uses of screen forms, see 
the screen format services concepts and facilities manual. 


9.6. SPECIAL ESCORT CONSIDERATIONS FOR FORMS CREATION 


ENTER DATA rules 


CHANGE DATA rules 


SELECT DATA rules 


Depending on the type of ESCORT program you use with a form 
(ENTER DATA, CHANGE DATA, SELECT DATA), the following 
requirements apply: 


ENTER DATA 

Specify all fields in the form as input (I). 

CHANGE DATA 

Specify all fields in the form as both input and output (B). 


Protect the decimal point in decimal numbers by using slashes 
on both sides of the decimal point (77.78). 


You cannot use packed decimal fields in a form. The initial 
display does not display underlines for the packed field. 


When the form is first displayed, only the key field is read. 
ESCORT ignores all other data until the master record is 
displayed and changed. 


SELECT (display) DATA 


Specify ail fields as both input and output (B) or as output only 
(O). When you display data using only output fields, you must 
define at least one input field to hold the screen until the 
XMIT key is pressed. ESCORT ignores any data sent from this 
input field (B or I). 


Regardless of the program type, when you output a print form, 
you are limited to 80 printer positions. 
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9.7. GUIDELINES FOR PRINTING CUSTOM FORMS WITH ESCORT 


Example 1 


Example 2 


These guidelines apply when using the OUTPUT TO PRINTER 
clause with a screen format form: 


= =«The number of lines printed for each form is exactly the same 
as the number of lines in the screen format generator form 
definition. If the form crosses a page boundary, a skip to top of 
page is done when the overflow line is reached. (The overflow 
line is defined by a SYSGEN parameter - the default is 55 
lines per page.) 


= You can control vertical spacing on the page by changing 
$LINE and using the OUTPUT TO PRINTER clause without a 
form to print a blank line. 


# $LINE in ESCORT is not incremented when a form is used. To 
cause page ejects, you must include a variable and code for 
counting lines or forms per page. When the limit for lines per 
page or forms per page is reached, the program should set 
$LINE equal to 1 and issue the OUTPUT TO PRINTER (BLANK) 
clause to print a blank line at the top of the next page. 


The system-defined number of lines per page is 55. This example 
has an 11-line screen form with blank lines at the top and bottom. 


In this case, no special processing is required. Five forms are 
printed on each page; the blank lines in the form control the 
vertical spacing. 


Sample program: 


SELECT DATA OF MASTER 
OUTPUT TO PRINTER (DATA, FORM11) 


In this example, each time the form begins, it is printed on a new 
page. The ejects occur as the result of an OUTPUT TO PRINTER 
clause of a line that contains all blanks. 


Sample program: 


SELECT DATA OF MASTER 
COMPUTING $LINE=1 
OUTPUT TO PRINTER (BLANK) 
OUTPUT TO PRINTER (DATA, FORM) 
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Example 3 This example shows a form with eight lines. Four copies of the @ 
form are printed per page with five blank lines between each form. 


In this example, control vertical spacing by changing $LINE and 
printing a blank line. Control ejects by incrementing a user-defined 
form counter. 


Sample program: 


SELECT DATA FROM MASTER 
WORKAREA (COUNTER) 


IF FIRSTIME 
COMPUTING $LINE = t 
COUNTER = 9 
END 


OUTPUT TO PRINTER (BLANK) 
OUTPUT TO PRINTER (DATA, FORM8) 


COMPUTING 
$LINE = $LINE+4, 
COUNTER = COUNTER+1 
IF COUNTER = 4 
COMPUTING 
S$LINE = 1 
COUNTER = 8 
END 





An example using custom structures to custom-format output is 
shown in Appendix G. 
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Appendix A. Program Statement 
Formats 


A.1. CHANGE DATA PROGRAM STATEMENT 


CHANGE DATA OF master-file [structure] 
FROM ad | eee i 
structure,form 
input-file [structure] 
[USING input-file-1 [structure],...,input-file-5 [structure]] 
WORKAREA structure [data replacement statements] 
SUBTOTALING fieldnames [‘‘literal expressions'’ ] 
TOTALING fieldnames [‘‘literal expressions’ ’ } 
IFfconditions) clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 
COMPUTING data replacement statements 
WHILE conditions clauses END 
CLEARING fieldnames 
PRINT ({(fieldnames [‘‘literal expressions’ '] 
SUBTOTALS 
TOTALS 
structure 


DISPLAYS {fieldnames [‘‘literal expressions’ ' ] 
SUBTOTALS 
TOTALS 
structure 


OUTPUT bs be ela | 
PRINTER) Ustructure,form 


EXIT 
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A.2. DELETE DATA PROGRAM STATEMENT 


DELETE DATA OF master-file [structure] 


FROMIWS teen ! 
structure,form 
input-file[structure] 


IF conditions 


A.3. ENTER DATA PROGRAM STATEMENT 


ENTER DATA FROM ia | eae 


structure,form 


1 


WORKAREA structure [data replacement statements] 


SUBTOTALING fieidnames [‘‘literal 


expressions’ ' } 


TOTALING fieldnames [‘‘literal expressions’ '] 
lFf{conditions)clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 


COMPUTING data replacement statements 


WHILE conditions clauses END 
CLEARING fieldnames 

CREATING output-file [structure] 
EXTENDING output-file [structure] 


PRINT} (fieldnames [‘‘literal expressions'’] 


SUBTOTALS 
TOTALS 
structure 


DISPLAY] f{fieldnames[‘‘literal expressions’ '] 


SUBTOTALS 
TOTALS 
structure 
OUTPUT ae ee 
PRINTERJ Iistructure, form 


EXIT 
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@ A.4. SELECT DATA PROGRAM STATEMENT 


SELECT DATA OF master-file [structure] 
FROM og [eee 
structure,form 
input-file [structure] 
[USING input-file-1 [structure],..., input-file-5 [structure]] 
WORKAREA structure [data replacement statements} 
SUBTOTALING fieldnames [‘‘literal expressions’ '] 


TOTALING fieldnames [‘‘literal expressions’ ’ ] 


IF(conditions)clauses [ELSE clauses] END 
FIRSTIME 
ENDOFILE 


COMPUTING data replacement statements 
WHILE conditions clauses END 

CLEARING fieldnames 

CREATING output-file [structure] 
EXTENDING output-file [structure] 
UPDATING input-file 


OUTPUT ve structure 
PRINTERJ (structure, form 


& PRINT} (fieldnames [‘‘literal expressions’ ’ J] 
SUBTOTALS 
TOTALS 
structure 


DISPLAY[| (fieldnames [‘‘literal expressions’ ] 
SUBTOTALS 
TOTALS 
structure 


EXIT 


A.5. SORT DATA PROGRAM STATEMENT 


SORT DATA OF master-file [structure] [BY field-1 
CREATING output-file [structure] 


ie aes field-6] 
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Appendix B. Reserved Words 


All words used in ESCORT statements are reserved words. You 
can't use them as file or field names, but you can use them as 
alphanumeric constants or in data you input or output. You can 
write reserved words in upper or lowercase, but when sorting or 
comparing alphanumeric data fields, lowercase letters have greater 
value than their uppercase counterparts. You must leave at least 
one space or special character between each reserved word. 





AND FIRSTIME 
FROM 
BY 
GE 
CHANGE GT 
CLEARING 
COMPUTING IF 
CONTAIN 
CONTAINS LE 
CREATING LT 
DATA NE 
DELETE NOT 
DISPLAY 
DOES OF 
OR 
ELSE OUTPUT 
END 
ENDOFILE PRINT 
ENDS PRINTER 
ENTER 
EQ SELECT 
EXIT SORT 


EXTENDING START 


STARTS 
SUBTOTALING 
SUBTOTALS 


TO 
TOTALING 
TOTALS 


UPDATING 
USING 


WHILE 

WITH 
WORKAREA 
WS 


SDATE 
SDAY 
SLINE 
SMONTH 
SPAGE 
STIME 
STITLE 
SYEAR 
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Appendix C. Function Key Use 


There are four processing modes in ESCORT: 
= Structure processor, which processes your structures 
= Program mode, which processes the programs you write 


Processing modes = Tutorial mode, which processes the tutorial programs you 
write 


= Run-time processor, which executes your programs 
@ Table C-1 lists the function keys and their actions under the 


different processors. 


Table C-1. Function Key Use 





LE 


Fl End of input, Not used Not used Not used 
return to 


master menu 










































F2 Cancel display Present a menu Not used 
output of subjects for 
which tutorial 
mode HELP is 
available 
F3 Cancel current Abort current Not used 
screen and tutorial processing 
return to and return to 
previous screen | beginning of 
tutorial mode 
F4 Abort structure Terminate free- | Abort tutorial Terminate 
and return to form input and processing and data input or 
menu return to return to workstation 
previous menu* | command mode display and 
return to 
caller** 
* The XMIT key (instead of F4) in program mode will also terminate input and return to 
the previous menu. 


** Calier refers to the ESCORT processor (program or tutorial mode) that called for a run- 
time function (i.e., program or job execution). If you're in tutorial mode, you'll return to 
tutorial mode. if you're in program mode, you'll return to the PROGRAM COMMANDS 
menu. 
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Appendix D. Programming 
Considerations and 
System Guidelines 


D.1. ARITHMETIC CONVENTIONS 


Definition 


Types allowed 


Definition 


Operation hierarchy 


Constants 


A constant is data whose value doesn’t change during program 
execution. ESCORT allows alphanumeric, numeric, and decimal 
constants. The following rules apply: 


Alphanumeric 

Enclose entire constant in quotation marks, e.g., “BIRD” 
Numeric and Decimal 

Arithmetic signs are permitted, but two signs cannot 


appear together. When they must, enclose the constant 
and its sign in parentheses, e.g., A=B*(-3). 


Arithmetic Operators 


The arithmetic operators are: 


+ 


/ 


Addition 

Subtraction 

Multiplication 

Division 

Modulo (a division operation where the result is the 
remainder portion only) 


In arithmetic expressions, multiplication, division, and modulo 
are performed before addition and subtraction. 
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The sequence for performing operations of the same level is 
left to right. 


§+3*4-2+ 10 = 25 


Use of parentheses In this example, the first operation performed is 3 * 4. Then 
5 is added to the product, 2 is subtracted, and 10 is added. 


Expressions enclosed within parentheses are evaluated first. 
When nested parentheses are used, evaluation begins with 
the innermost set and works outward. 


((5+3)*4—-(2 + 10))=20 


D.2. KEY MATCHING IN A MULTIKEY ENVIRONMENT 


By default, the first key specified in a structure becomes the key of 
reference (i.e., the first key specified, not the lowest key number). 
Access to the file is based on this key. The following examples show 
how ESCORT accesses files using different key positions. 


Example 1 STRUC1 


| FlELD1 
FIELD2 
FIELD3 


FIELD4 
FIELD5 


SSE SS 





Program SELECT DATA OF MASTERFIL (STRUC1) DISPLAY 


In example 1, MASTERFIL is accessed sequentially by key 1 (field 
FIELD1) and the records are displayed accordingly. 


Example 2 STRUC2 


| FleLD1 
FIELD2 


FIELD3 
FIELD4 





FIELDS 


Program SELECT DATA OF MASTERFIL (STRUC2) DISPLAY 


In example 2, MASTERFIL is accessed sequentially by key 2 (field 
FIELD2) and the records are displayed accordingly. 
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Program 


Example 4 


Program 
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You can override the default key of reference by establishing key 
matching criteria between a master file and input file. The 
overriding of the default occurs once, creating a hierarchical 
relationship among input files matching the master file. Files or 
workstation keys in the FROM designation take precedence over all 
references of USING files. Likewise, each USING file takes 
precedence over the following USING file in establishing the master 
key of reference. 


Key matching involves finding the key field in the input structure 
and finding the identical field in the master file. In the case of 
matching between the FROM input file and the master file (i.e., 
SELECT DATA OF MASTERFIL (STRUC1) FROM INPUT (STRUC3)), 
the matching field in the master file must be a key. Matching 
between secondary input and master file does not require that the 
matching master file field be a key. 


In example 3, the secondary input file changes the key of reference 
from the default key (key 1) to key 3. 


STRUC1 STRUC3 


) FIELD1 
FIELD2 
FIELD3 


| FIELD4 
| FIELDS 


AGREE 





SELECT DATA OF MASTERFILE (STRUC1) USING SECINPUT (STRUC3) DISPLAY 


Key matching is established between field FIELD5 in STRUC3 and 
field FIELDS in STRUC1 by selecting the key field in the input 
structure and finding the matching field in the master file. Based on 
field FIELDS as the matching field, MASTERFILE is read, the value in 
FIELD5 is used as the key in reading the file SECINPUT. 


In example 3, if the structure STRUC1 was changed deleting key 3 
and the program recompiled, the processing will change. 
STRUC4 STRUC3 
4 FleLD1 “| FIELD1 


FIELD2 FIELD2 
FIELD3 FIELD3 


FIELD4 FIELD4 
FIELDS FIELD5 





SELECT DATA OF MASTERFIL (STRUC4) USING SECINPUT (STRUC3) DISPLAY 
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Again, key matching is established between field FIELD5 in STRUC3 
and field FIELD5 in STRUC4. However, because symbol FIELD5 in 
the master file is not a key, overriding of the key does not take place. 
Key 1 (field FIELD1) is the key of reference by default. The master 
file is read sequentially by key FIELD1. After the master file is read, 
the value in FIELDS is used as the key in the reading of the file 
SECINPUT. The access to SECINPUT could change if the way the 
master file is read changes. 


D.3. USES OF THE SLINE SYSTEM UTILITY FIELD 


With a user-supplied format, structure only 
ESCORT clause: OUTPUT TO PRINTER (structure-name) 


The $LINE system utility field is most effectively used this 
way. Line control by the ESCORT program becomes effective 
when SLINE is set to some non-zero value. When SLINE is set 
before an OUTPUT TO PRINTER clause, ESCORT controls the 
printer output based on the current line position as compared 
to the value of SLINE. 


1. If SLINE is the same as the current printer line position, 
the line is printed and $LINE is incremented by one. 


2. If SLINE is greater than the current line position, the 
printer is advanced to $LINE, the line is printed, and 
SLINE is incremented by one. 


3. If $LINE is less than the current line position, the printer 
is skipped to the next page and advanced to $LINE. Then 
the line is printed, and $LINE is incremented by one. 


With a user-supplied format, structure and form 


ESCORT clause: OUTPUT TO PRINTER (structure- 
name,formname) 


The number of lines printed is controlled by the screen format 
coordinator, not by ESCORT. Therefore, the $LINE system 
utility field can only be used to cause page ejects. This is done 
by setting $LINE to a value greater than the number of lines 
that will fit on a page (e.g., SLINE = 67 if page size is 66). 


With automatic forms 
ESCORT clause: PRINT 


The S$LINE system utility field has no effect on automatic 
forms. 
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D.4. USING A DATA FILE WRITTEN IN ANOTHER LANGUAGE 


ESCORT can access files written in other languages, such as 
COBOL, BASIC, FORTRAN, and RPG Il. The only restriction is that 
the files you want to access from ESCORT must be MIRAM files. 


Call these files the same way you call an ESCORT file. When 
ESCORT prompts you for a file name, just key in the name of any 
cataloged file written in another language. ESCORT permits file 
names of up to 44 characters. The first character must be 
alphabetic. 


When an MS-type file is created with COBOL, ORGANIZATION IS 
RELATIVE should be specified for the file. If ORGANIZATION IS 
SEQUENTIAL is specified and an attempt is made to access the 
records out of order, a data management error occurs, and 
execution of the ESCORT program terminates. 


FILE SHARING GUIDELINES 


File usage in an ESCORT program determines the type of OPEN 
generated. Basically, ESCORT uses four modes. 


1. SRD - Read mode, allowing other readers. 

2. EXC - Exclusive write, allowing no other users. The file 
is initialized. 

3. EXCR - Update mode, allowing read users but no other 
update. 

4. SADD_ - Update (extend) mode, allowing other users in 


the same mode. 
The following program uses five files and illustrates all modes: 


SELECT DATA OF PRCMASTER 
FROM PRICE 

USING PRCREF 
COMPUTING TOTALPRC = 
IF NUMITEMS = 9 
CREATING PRCERROR 
ELSE 

EXTENDING PRCREC 
UPDATING PRCMASTER 
END 


PRICE * NUMITEMS 
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PRCMASTER 
PRICE 
PRCREF 
PRCERROR 
PRCREC 


EXCR UPDATING 
SRD FROM 

SRD USING 

EXC CREATING 
SADD EXTENDING 


The object file of the DELETE or CHANGE verb is treated the same 
as a file used in an UPDATING clause. 


Violation of the file sharing guidelines of the system will result in 
display of an error message. 


D.6. ESCORT SORTING SEQUENCE 


The sequence of the records in the output file of an ESCORT sort 
program is governed by the following rules: 


1. The sort key is treated as an unsigned bit string. Therefore, 
numeric data (packed and decimal) will not be sorted according 
to algebraic sign. 


2. The collating sequence for character strings is determined by 
the internal machine representation of the character set. 


D.7. ESCORT LIBRARY MODULE TYPES 


The ESCORT 
included: 


Type 
ESCS 
ESCO 


ESAF 


ESCJ 


ESFD 


library is a MIRAM library. Five types of modules are 


Description 
Source language program 
Object program 


Created in conjunction with the object program when 
automatic formatting is used 


Job 


Structure 


If ESCORT object modules are copied, renamed, or deleted by a 
system processor other than ESCORT, the corresponding ESAF 


module must 


also be copied, renamed, or deleted. 
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Appendix E. Error Messages 


This section contains the error messages you may receive in the 
course of your ESCORT processing: 


= Compiler syntax errors 

= Compiler errors 

@ Structure errors 

= Program mode errors 
8 = «Tutorial mode errors 

= Run-time errors 


Most error messages tell what caused the error and how to remedy 
it. 


The structure error messages tell only what caused the error. When 
a structure error occurs, a menu appears listing various options to 
remedy the error. Because the remedy is your choice, we've not 
listed the remedies here. 
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ESCO65 WARNING - NAME EXCEEDS 8 ESCO072 INVALID FILE NAME 
CHARACTERS 
This program is caused by one of the following: 


A field name is longer than eight characters. The 


compiler truncates the field name at _ eight 1. The file name is WS and the clause is not 
characters. FROM or OUTPUT TO. 
If the field name is unique in the first eight 2. Something other than WS or PRINTER is 


characters, your program will be correct. If not, used in an OUTPUT TO clause. 

shorten the field name. 

3: Something other than WS is used in the 
FROM clause with the ENTER DATA program 


statement. 


ESCO66 WARNING - ‘END’ CLAUSE MISSING 


During processing of an !F or WHILE clause, the end 
of the program was reached, or during processing of 
a nested IF or WHILE clause, the ELSE portion of 
the outer IF clause was encountered. The compiler 
assumes that the clause being processed is to end 


Correct the program and attempt to recompile it. 


ESCO73 COMPILER TABLE CAPACITY EXCEEDED 


at this point. 


If the assumption is correct, your program will be 
correct. Otherwise, insert the missing END clause 
at the appropriate place in the program. 


The program references more structures, symbols, 
or literals than the compiler table can store. The 
structure, symbol, or literal that caused the error is 
indicated by where the message appears in the 


program. @ 


ESC067 INVALID UTILITY FIELD Restructure the program to remove excess 
structures, symbols, or literals. 





A field name begins with a $ but is not the name of 
an ESCORT utility field. ESC074 INVALID CLAUSE FOUND 
Correct the field name in error and attempt to 
recompile the program. 


This error could be caused by: 


1. A misspelled clause 
ESCO68 NUMBER IS TOO LARGE 
2. A syntax error 
A number contains more than 15 digits or more 
than 9 decimal places. 3. Punctuation of a clause 


Correct the program and attempt to recompile it. Correct the program and attempt to recompile it. 


ESCO69 MORE THAN 700 SYMBOLS USED ESCO75 INVALID STRUCTURE NAME 

More than 700 different field names are used in the The structure name given is not a valid structure 

program. name. Either it does not exist as written or no 
structure name is specified. 

Reduce the number of field names used in the 


program. Attempt to recompile the program. Correct the program and attempt to recompile it. 


ESCO70 INVALID KEYWORD FOUND ESCO76 BAD DELIMITER FOUND 

The first word of the program is not ENTER, A right parenthesis is required but another delimiter 
CHANGE, SELECT, SORT, or DELETE. Or these was found. 

program statements are encountered somewhere 
other than the first position in a program. Correct the program and attempt to recompile it. 


Correct the program and attempt to recompile it. © 
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ESCO077 INVALID FORM NAME 


Something other than a form name is present 
where a form name is expected. 


Correct the program and attempt to recompile it. 
ESCO78 CONSTANT EXPECTED 


A data replacement statement in a WORKAREA 
clause attempted to assign a value other than a 
constant to some variable. Data replacement 
statements in a WORKAREA clause are used only to 
assign constants as initial values of a WORKAREA 
variable. 


Delete or correct the invalid data replacement 
statement. Attempt to recompile the program. 


ESCO79 NO CLAUSE FOR OUTPUT (E.G., CREATING) 


An ENTER DATA or SELECT DATA program 
produces no output. 


Include one of the following output clauses in the 
program: CREATING, EXTENDING, DISPLAY, PRINT, 
OUTPUT TO, or UPDATING (used only with the 
SELECT DATA program statement). Attempt to 
recompile the program. 


ESCO80 CREATING CLAUSE REQUIRED 
The CREATING clause is missing from the SORT 
DATA program statement, or a clause other than BY 
precedes the CREATING clause. 
Correct the program and attempt to recompile it. 
ESC081 INVALID ALPHANUMERIC LITERAL 
An alphanumeric titeral was not enclosed by a 
quotation mark or two quotation marks appeared 


with nothing between them. 


Correct the program and attempt to recompile it. 


SPERRY UNIVAC 0S/3 E-3 
ESCORT 


COMPILER 
SYNTAX 

ERROR 

MESSAGES 








ESCO82 ‘=’ EXPECTED 
A data replacement statement used in a 
COMPUTING or WORKAREA clause does not have 
an equal sign where one should appear. 
Correct the program and attempt to recompile it. 
ESCO83 FIELD NAME EXPECTED 
The BY clause of the SORT DATA program 
statement contains something other than a field 
name. 
Correct the program and attempt to recompile it. 


ESC084 INVALID CONDITION 


A condition specified in an IF or WHILE clause is 
invatid. 


Correct the program and attempt to recompile it. 
ESCO85 FILENAME EXCEEDS 44 CHARACTERS 


The maximum length for a file name is 44 
characters. 


Correct the program and attempt to recompile it. 
ESCO86 BAD OPERAND IN CHARACTER RELATION 

The first operand of a character relation (character 

string operand) is something other than a field 

name. 

Correct the program and attempt to recompile it. 
ESC087 BAD CONDITIONAL OPERATOR 

Something other than a conditional operator (AND 

or OR) or a reserved word was encountered in an IF 


or WHILE conditional expression. 


Correct the offending conditional expression. 
Attempt to recompile the program. 
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ESCO88 ERROR IN 
XXXXXXAXXKXKXXKXXXXKXAKXAXAXXXXXX CLAUSE 


The error is in one of the following clauses: 


1. CLEARING - The CLEARING clause must 
contain a list of the field names to be cleared. 
This error occurs if something other than a 
field name is present. 


2. COMPUTING - The COMPUTING clause must 
contain at least one data replacement 
statement. This error is caused by lack of or 
erroneous data in a data replacement 
statement. 


3. DISPLAY or PRINT — A PRINT or DISPLAY 
clause contained an invalid specification. The 
only legal parameters are: SUBTOTALS, 
TOTALS, structure-name, and fieldnames 
and literal expressions. 


4. SUBTOTALING or TOTALING - The 
SUBTOTALING or TOTALING clause contains 
something other than a field name, a system 
utility field, or a literal expression. 


Correct the program and attempt to recompile it. 
ESCO89 FORM SPECIFICATION NOT ALLOWED 
Use of the formname parameter is invalid. The 


formname parameter following a structure name is 
valid only with: 


1. The OUTPUT TO clause 


2: The FROM WS clause of the ENTER DATA, 
CHANGE DATA, and SELECT DATA program 
statements 


Correct the program and attempt to recompile it. 
ESCO90 INVALID ARITHMETIC FACTOR 

An invalid arithmetic factor was encountered (e.g., 

assigning an aiphabetic value to a numeric field, 


using a literal expression, etc). 


Correct the invalid factor. Attempt to recompile the 
program. 
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ESCO91 PROGRAM EXCEEDS COMPILER TABLE 
SIZE 


The program being compiled generated more code 
than can be handled in the compiler table area. 


Reduce the size of the program. Attempt to 
recompile the program. 


ESCO92 STRUCTURE SPECIFICATION MISSING 
The OUTPUT TO or WORKAREA clause does not 
have a specified structure, or the left parenthesis is 


missing from the structure specification. 


Correct the program to include the missing 
structure. Attempt to recompile the program. 


ESCO93 INVALID FIELD NAME QUALIFIER 


This error could be caused by: 


1, A qualifier name longer than 44 characters 

2. No qualifier is named even though OF is 
present 

3. The qualifier name does not match the name 


given in the OF, FROM, or USING clauses. 
Correct the program and attempt to recompile it. 
ESC094 INVALID SUBSCRIPT 


An error was encountered in a subscript (array) 
expression. 


Correct the program and attempt to recompile it. 

ESCO95 ENDOFILE OR FIRSTIME IN NESTED IF 
The ENDOFILE or FIRSTIME system operators must 
appear in an initial IF clause. These operators 
cannot be embedded within a nested IF. See the IF 
clause for usage rules. 


Correct the program and attempt to recompile it. 


ESCO96 EXTRA XXXXXXXXXXXXXXXXXXXXXXXXX 
CLAUSE FOUND 


The program contains more than one 
SUBTOTALING, TOTALING, or WORKAREA clause. 
Only one of each is aliowed. 


Correct the program and attempt to recompile it. 
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ESC0O97 SUBSCRIPT LITERAL NOT INTEGER 


A number in a subscript (array) contains an illegal 
decimal. All numbers in subscripts must be 
integers. 


Correct the subscript to an integer number. Attempt 
to recompile the program. 


ESCO98 INVALID ARITHMETIC EXPRESSION 


Something was encountered that is illegal in an 
arithmetic expression (e.g., an invalid separator, 
parentheses with no value enclosed, etc). 


Correct the invalid expression. Attempt to recompile 
the program. 


ESCO99 DELETE CRITERIA MISSING 
The IF or FROM clause is missing from the DELETE 
DATA program statement, or an invalid clause 
precedes the IF or FROM clause. 
Correct the program and attempt to recompile it. 


ESC100 EXTRANEOUS INPUT ENCOUNTERED 


A SORT DATA or DELETE DATA program statement 
contains more clauses than are allowed. 


Correct the program and attempt to recompile it. 


ESC101 IF, WHILE CLAUSES NESTED MORE THAN 
nn LEVELS 


The program contains nested IF or WHILE clauses 
that exceed the storage capacity of the compiler. 


Reduce the number of nested IF or WHILE clauses. 
Attempt to recompile the program. 


ESC102 MORE THAN 12 FILES USED 
More than 12 different file names, other than those 
used in the OUTPUT TO clause, appear in the 


program. 


Reduce the number of files. Attempt to recompile 
the program. 
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—ESC103 ONLY ONE XXXXXXXXXXXXXXXX 
ALLOWED 


The program contains more than one IF ENDOFILE 
or IF FIRSTIME clause. 


Put all processing statements that are dependent on 
these conditions under a single IF ENDOFILE or IF 
FIRSTIME condition. Attempt to recompile the 
program. 


ESC104 SUBSCRIPTS MAY BE NESTED ONLY 2 
LEVELS 


Subscripted (array) fields in a  subscripted 
expression are nested to a depth greater than 2. 


Simplify the subscripted expression. Attempt to 
recompile the program. 


ESC105 XXXXXXXXXXXXXXXX NOT PRINTED 


The program contains a TOTALING or a 
SUBTOTALING clause but no corresponding PRINT 
or DISPLAY TOTALS or SUBTOTALS clause. 


Insert the applicable PRINT or DISPLAY clause. 
Attempt to recompile the program. 


ESC106 XXXXXXXXXXXXXXXX PRINTED, BUT NOT 
SPECIFIED 


The program contains a PRINT TOTALS or DISPLAY 
TOTALS clause, but no TOTALING clause was 
specified. Or, the program contains a PRINT 
SUBTOTALS or DISPLAY SUBTOTALS clause, but 
no SUBTOTALING clause was specified. 


Insert the applicable TOTALING or SUBTOTALING 
clause. Attempt to recompile the program. 


ESC107 ILLEGAL CHARACTER FOUND 


There is a character in the program which is neither 
alphanumeric or a valid ESCORT symbol. 


Correct the program and attempt to recompile it. 


ESC108 EXPRESSIONS MAY BE NESTED ONLY 20 
LEVELS 


Parentheses are nested to a depth greater than 20 
in an expression. 


Simplify the expression. Attempt to recompile the 
program. 
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ESC109 STRUCTURE NOT SPECIFIED FOR WS 


No structure was specified for workstation input in 
an ENTER DATA program that does not include a 
CREATING or EXTENDING clause. 


Specify a structure for use with workstation input or 
include a CREATING or EXTENDING clause. Attempt 
to recompile the program. 


—SC110 ENDOFILE INVALID WITHOUT A FILE 


An ENDOFILE condition was encountered in an 
ENTER DATA program that does not include a 
CREATING or EXTENDING clause. 


Remove the ENDOFILE condition or add a 
CREATING or EXTENDING clause. Attempt to 
recompile the program. 


ESC111 UPDATE STRUCTURE MUST MATCH INPUT 
The structure used for the file named in an 
UPDATING clause is not the same as the structure 
used for another occurrence of the file. 

Specify in the UPDATING clause the same structure 
used for the file in the OF, FROM, or USING clause. 
Attempt to recompile the program. 


ESC112 MORE THAN 6 SORT FIELDS 


Only six sort fields may be specified in the BY 
clause. 


Correct the program and attempt to recompile it. 
ESC113 NO BUFFER AVAILABLE FOR COMPILATION 


The ESCORT compiler attempted to acquire a buffer 
from the system, but none was available. 


Attempt to compile the program when the system is 
not so busy. 
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ESC114 FILE USE CONFLICTS WITH PREVIOUS USE 


The file name appears in a CREATING clause and 
another type of clause, or the file name appears in 
an EXTENDING clause and another type of clause. 


Correct the program and attempt to recompile it. 
ESC115 UPDATE FILE MUST BE USED FOR INPUT 


The file name appears in an UPDATING clause, but 
not in an OF, FROM, or USING clause. 


Correct the program and attempt to recompile it. 


ESC116 ILLEGAL XXXXXXXXXXXXXXXXXXXXXXXXX 
CLAUSE 


The error is in one of the following clauses: 


1. ELSE - There is no matching IF preceding this 
clause. 


2. END - There is no matching IF or WHILE 
preceding this clause. 


3. CREATING - This clause is used only with the 
ENTER DATA, SELECT DATA, and SORT 
DATA program statements. 


4. EXTENDING - This clause is used only with 
the ENTER DATA and SELECT DATA program 
statements. 


5. UPDATING - This clause is used only with 
the SELECT DATA PROGRAM statement. 


Correct the program and attempt to recompile it. 


ESC120 ITEM IS NOT A FIELD NAME OR AN ALPHA 
LITERAL 


One of the following clauses was used incorrectly: 


1. TOTALING, SUBTOTALING - Only field 
names and alphanumeric literals may be 
used with these clauses. 


2. PRINT, DISPLAY - A field name or 
alphanumeric titeral was expected, but 
something else was encountered, or the 
clause was followed by an invalid clause. 
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ESC128 SYMBOL XXXXXXXX NOT DEFINED IN 
STRUCTURE 


The field name shown is not defined in an input or 
WORKAREA structure. 


Correct the program and attempt to recompile it. 
ESC129 STRUCTURE XXXXXXXX NOT FOUND 


The specified structure does not exist on either the 
session workfile or the ESCORT library file. 


Check to make sure you are using a valid structure 
name. Correct the program and attempt to 


recompile it. 


ESC130 ALPHANUMERICS NOT ALLOWED IN 
NUMERIC COMPUTING 


A numeric computing clause may not include 
specification of alphanumeric fields and literals. 


Correct the offending clause. Correct the program 
and attempt to recompile it. 


ESC131 INPUT FILE MUST HAVE ONE/ONLY ONE 
KEY 


All input files are allowed only one key. 
Correct the program and attempt to recompile it. 
ESC132 INVALID INPUT MASTER MATCH 


The input key for SELECT does not have a matching 
symbol key value in the master file. 


Correct the program and attempt to recompile it. 


ESC133 MU MASTER INVALID FOR INPUT/MASTER 
MATCH 


The master file must be sorted for input/master 
matching. 


Correct the program and attempt to recompile it. 

ESC134 INVALID SUBSCRIPT FOR THIS CLAUSE 
Only simple subscripts may be used with PRINT or 
DISPLAY clauses. For example: A(B) is valid; A(B(C)) 
and A(B+C) are invalid. 


Correct the program and attempt to recompile it. 
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ESC135 COMPUTING INVALID FOR THIS CLAUSE 


No computation may be done with field names 
included in PRINT or DISPLAY clauses. 


Correct the program and attempt to recompile it. 
£SC136 CODE GENERATION OVERFLOW 
Your code has exceeded the allowable limit. 


Restructure the program so the code stays within 
the limits. 


ESC137 STRUCTURE TABLE OVERFLOW 


The number of fields defined in the program has 
caused the structure table to overflow. 


Reduce the number of fields used in the program. 
Correct the program and attempt to recompile it. 


ESC138 AUTOFORM WORKSTATION SIZE 
EXCEEDED 


The physical size of the workstation cannot 
accommodate the structure size. 


Try to reduce the structure size or, if output is 
involved, make more than one structure with 
multiple displays. 


ESC139 AUTOFORM ARRAY SIZE EXCEEDED 


The size of an array element is limited to the length 
of a line on the printer or workstation with which it 
is to be used. 


Correct the program and attempt to recompile it. 
ESC140 AUTOFORM TABLE OVERFLOW 


All of the field names and field sizes from all of the 
PRINT and DISPLAY clauses will not fit in the 
maximum buffer size. 


Reduce the number of PRINT and DISPLAY clauses. 
Correct the program and attempt to recompile it. 


ESC141 INVALID WORKAREA INITIALIZATION 
An alphanumeric field is not initialized with an 
alphanumeric literal, or a packed field is not 


initialized with a packed literal. 


Correct the field in error. Attempt to recompile the 
program. 
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ESC142 SYSTEM MEMORY NOT AVAILABLE 


ESCORT attempted to acquire a buffer from the 
system but none was available. 


Attempt to compile the program when the system is 
not so busy. 


ESC143 MAXIMUM SORT KEY LENGTH EXCEEDED 


The combined length of all specified sort fields 
exceeds 80 characters. 


Reduce the total size of the sort field or use the 
OS/3 sort. 


ESC145 UNABLE TO LOAD MODULE XXXXXXXX, 
ERROR CODE = NNN 


An error has occurred during an attempt to load an 
ESCORT module. 


If the error is known to be fatal to the ESCORT 
session, the following message is also displayed. 


MEMORY MANAGEMENT ERROR REQUIRES 
IMMEDIATE TERMINATION, XMIT 


If recovery of the ESCORT session can be 
attempted, this message is displayed instead: 


PRESS TRANSMIT TO RETURN TO THE 
COMMAND MENU. 


ESC150 ALPHA TO NUMERIC/NUMERIC TO ALPHA 
IMPLIED MOVE INVALID 


You may not move an alphanumeric field to a 
numeric field or a numeric field to an alphanumeric 
field during implied moves for CREATING or 
EXTENDING clauses. 

Correct the program and attempt to recompile it. 


ESC151 SYMBOL XXXXXXXX SUBSCRIPT MUST BE 
‘N’, ‘B’, OR ‘P’ TYPE FIELD 


A symbol used as a subscript must identify a 
numeric, binary, or packed field. 


Correct the program and attempt to recompile it. 


ESC152 NUMERIC NOT ALLOWED IN 
ALPHANUMERIC COMPUTING/COMPARE 


An alphanumeric clause may not’ include 
specification of numeric fields or literals. 


Correct the program and attempt to recompile it. 
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ESC153 SYMBOL XXXXXXXX ALPHANUMERIC TYPE 
FIELD NOT ALLOWED IN SUBTOTALING TOTALING 


Only numeric field types may be specified for 
SUBTOTALING or TOTALING clauses. 


Correct the program and attempt to recompile it. 


ESC154 SYMBOL XXXXXXXX SUBTOTALING 
TOTALING OF NONSUBSCRIPTED ARRAY FIELDS 
NOT ALLOWED 


Only individual elements of arrays may be specified 
for SUBTOTALING or TOTALING. 


Correct the program and attempt to recompile it. 


ESC155 MASTER FILE HAS NO KEY FOR 
WORKSTATION PROMPT 


The structure specified for use with the master file 
must include a key to be used for identifying desired 
records from the workstation. 


Correct the program and attempt to recompile it. 


ESC156 SYMBOL XXXXXXXX DECIMAL DIGITS IN 
PACKED SUBSCRIPT FIELD 


Packed fields are allowable for subscripting only 
when the specified length of the decimal portion of 
the field is O. For example: Z specified as 5PO is 


valid for use as a subscript; Z1, specified as 5P2 is 
not. 


Correct the program and attempt to recompile it. 


ESC157 SYMBOL XXXXXXXX SUBSCRIPT 
REFERENCE TO NONARRAY SYMBOL ENTRY 


Only elements of arrays may be referenced by 
subscripting. 


Correct the program and attempt to recompile it. 


ESC158 SECONDARY INPUT KEY HAS NO 
MATCHING SYMBOL IN INPUT/MASTER 


The symbol used for a secondary input file key must 
be defined in the master or input file structure. 


Correct the program and attempt to recompile it. 
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ESC159 VALID ITEMS FOR THIS CLAUSE ARE ITEMS 
AND LITERAL EXPRESSIONS 


This clause may include only field names from a 
structure and literal expressions. 


Correct the program and attempt to recompile it. 
ESC160 SYMBOL XXXXXXXX ALPHA FIELD NOT 


ALLOWED IN COMBINATION WITH UNARY 
VALUES 


Only numeric type fields may be specified with 
unary values. 


Correct the program and attempt to recompile it. 


ESC161 SYMBOL TABLE/LITERAL TABLE LIMITS 
EXCEEDED 


Too many symbols or literals have been specified in 
this program. 


Correct the program and attempt to recompile it. 
ESC162 SYMBOL XXXXXXXX WORKAREA 
INITIALIZATION FIELD NOT IN WORKAREA 
STRUCTURE 

1. Only fields defined in the structure specified for 

the WORKAREA may be initialized in the 

WORKAREA,; or 


2. A field specified in the WORKAREA structure is 
also defined in the master or input file structure. 


Correct the program and attempt to recompile it. 


ESC163 SYMBOL XXXXXXXX ARRAY ENTRY IS NOT 
SUBSCRIPTED 


References to fields defined as arrays must include 
subscripts to identify individual array elements. 


Correct the program and attempt to recompile it. 


ESC164 SYMBOL XXXXXXXX REPEAT COUNT NOT 
COMPATIBLE FOR IMPLIED MOVE 


When creating an input file, the repeat counts must 
be compatible between input and output fields. 


Correct the program and attempt to recompile it. 
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ESC165 SYMBOL XXXXXXXX DECIMAL DIGITS IN 
‘N’ or ‘B’ TYPE WORKAREA INITIALIZATION 


Only integer values are valid in numeric and binary 
type fields. 


Correct the program and attempt to recompile it. 


ESC166 INVALID SUBSCRIPT IN WORKAREA 
INITIALIZATION 


The subscripted WORKAREA initialization is invalid. 
For example: A(1)}=1, A(2)}=2, and A(3)=3 are valid. 
But A(I)=5 and A(2*3)=4 are invalid. 


Correct the program and attempt to recompile it. 


ESC167 *WARNING* OUTPUT TO PRINTER 
OVERLAP NUMERIC FIELDS ARE EXPANDED 


The OUTPUT TO PRINTER clause is used to 
customize printer output. When data is moved from 
the input files to the output buffer, the fields are 
edited via the structure edit codes. However, the 
positions are not changed so as not to disturb the 
user form positioning. if the fields now overlap, this 
message is displayed. 


To avoid the problem, allow for the edited 
(expanded) field sizes in creating the printer output 
structure. Attempt to recompile the program. 


ESC168 WORKSTATION INPUT DOES NOT 
PROCESS REDEFINE FIELDS 


A structure to be used for workstation input may not 
include redefined fields on the key if the key is to be 
used as a record prompt. 


Correct the program and attempt to recompile it. 


ESC169 NO SORT KEY, USE BY CLAUSE OR MS KEY 
ON OUTPUT STRUCTURE 


No sort key was specified. Sort keys must be 
identified by using the BY clause with fields in the 
master file structure, or by designating an MS field 
on the output file structure. 


Correct the program and attempt to recompile it. 
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ESC199 STRUCTURE DOES NOT EXIST ON 
SPECIFIED FILE 


An attempt was made to delete a structure that 
does not exist on the file specified. 


ESC200 LINE nn DUPLICATE FIELD NAME 
The field name already appears in the structure. 


ESC201 LINE nn ILLEGAL LENGTH FOR 
ALPHANUMERIC FIELD 


1. An illegal character was used in the length. 


2. An embedded blank was found in the length. 


3. The length of an alphanumeric field is zero. 
4. The length of an alphanumeric field is greater 
than 4092. 


ESC202 LINE nn LENGTH OF FIELD CANNOT BE 
ZERO 


The sum of the integer and decimal portion of a P 
field or a V field totals zero. 


ESC203 LINE nn ILLEGAL DECIMAL LENGTH FOR ‘V’ 
TYPE DATA 


V type data must have a decimal portion greater 
than zero, but less than or equal to 9. 


ESC204 LINE nn ILLEGAL LENGTH FOR ‘B’ TYPE 
FIELD 


1. An illegal character was found in the length. 
2. An embedded blank was found in the length. 
3. The length of a B field is zero. 

4. The length of a B field is greater than 9. 


ESC205 LINE nn TOTAL LENGTH OF NUMERIC FIELD 
EXCEEDS 15 


The sum of the integer and decimal! portions of a P 
or V field exceeds 15. 


ESC206 LINE nn DECIMAL PORTION ILLEGAL WITH 
DATA TYPE USED 


A decimal portion appears after the type for an N or 
B field. 
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ESC207 LINE nn ILLEGAL DATA TYPE SPECIFIED 


1. A data type other than A, N, B, P, or V was 
specified. 


2. No data type was specified. 


ESC208 LINE nn ILLEGAL COMBINATION OR 
DUPLICATE KEY FOUND 


1. The specified key already appears in the 
structure. 


2. An index key was specified in the same 
structure with a matching key. 


3. A matching sorted key and a matching 
unsorted key were specified in the same 


structure. 


ESC209 LINE nn ILLEGAL START POSITION 
SPECIFIED 


The start position specification is greater than 4092. 
ESC210 LINE nn ILLEGAL KEY SPECIFIED 
A key other than K1-K5, MU, or MS was specified. 


ESC211 LINE nn EDIT CODES NOT ALLOWED WITH 
ALPHA FIELD 


You cannot specify an edit code in an alphanumeric 
field. 


ESC212 LINE nn DUPLICATE EDIT CODE SPECIFIED 
The same edit code is already specified for the field. 
ESC213 LINE nn ILLEGAL EDIT CODE SPECIFIED 


An edit code other than Z, $, *, ,, -, or / was 
specified. 


ESC214 LINE nn ILLEGAL REPEAT COUNT 
SPECIFIED 


The repeat count specification is greater than 255. 


ESC215 LINE nn REPEAT COUNT NOT PERMITTED 
WITH KEYS 


A repeat count is specified in a field containing a 
key. 
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ESC216 LINE nn STRUCTURE LENGTH GREATER 
THAN 4092 


The position of the field in the record exceeds 4092. 


ESC217 LINE nn Z EDIT CODE NOT PERMITTED 
WITH (*) or ($) 


The Z edit code cannot be used with the * or $ edit 
codes because these codes imply zero suppression. 


ESC218 LINE nn ILLEGAL FIELD LENGTH USING ‘/’ 
EDIT CODE 


The length of the specified field must be 4 or 6 to 
use the / edit code. 


ESC219 LINE nn ILLEGAL DATA TYPE USED WITH (/) 
EDIT CODE 


Only numeric (N) data may be used with the / edit 
code. 


ESC220 LINE nn BAD SYMBOL OR EMBEDDED 
BLANK IN FIELD NAME 


1. Blanks cannot precede or be included in field 
names. 
2. A character other than alphabetic or numeric 


was found in a field name. 


ESC221 LINE nn FIELD NAME CANNOT BE 
RESERVED WORD 


The field name cannot be an ESCORT reserved 
word. 


ESC222 LINE nn FIRST CHARACTER OF NAME 
MUST BE ALPHABETIC 


Field names must begin with alphabetic characters. 


ESC223 LINE nn MORE THAN 200 ENTRIES IN 
STRUCTURE 


A maximum of 200 structure statements is 
permitted in a structure. 


ESC224 LINE nn ILLEGAL DECIMAL PORTION 
SPECIFIED 


1; A decimal portion greater than 9 was 
specified for a P or V field. 


2. The remainder of the length/type field was 
not blank following the decimal portion. 
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ESC225 LINE nn ILLEGAL INTEGER PORTION FOR ‘P’ 
OR ‘V’ TYPE 


1. An illegal character was detected in the 
length of the field. 


2. A blank was found in the length of the field. 


ESC226 LINE nn OTHER CODES NOT PERMITTED 
WITH (7) EDIT CODE 


The / edit code cannot be used in combination with 
any other edit code. 


ESC227 LINE nn ‘S’ PREFIX USED ONLY WITH ‘N’ 
AND ‘V’ DATA 


Only data types that store the sign as an overpunch 
can use the S prefix. 


ESC228 LINE nn INDEX KEY CANNOT EXCEED 80 
CHARACTERS 


A MIRAM key cannot be longer than 80 characters. 


ESC229 ESCORT LIBRARY LOCKED - SAVE 
OPERATION CANCELLED 


Another user is using the ESCORT library file. 
Retry the command. 


ESC230 UNABLE TO WRITE STRUCTURE 
SUCCESSFULLY TO FILE 


If saving a structure, the ESCORT library file cannot 
be accessed for writing. Otherwise, the session file 
cannot be accessed for writing. 


ESC231 SPECIFIED STRUCTURE DOES NOT EXIST 


The structure specified does not exist on either the 
ESCORT library file or the session file. 


ESC232 ILLEGAL STRUCTURE NAME ENTERED 


1. An embedded blank appears in the structure 
name. 

2. An illegal character appears in the structure 
name. 

3. The first character of the structure name is 


not alphabetic. 
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ESC233 STRUCTURE NAME CANNOT BE A 
RESERVED WORD 


The structure name specified was an ESCORT 
reserved word. 


ESC234 SPECIFIED STRUCTURE DOES NOT EXIST 
ON ESCORT SESSION FILE 


The SAVE STRUCTURE command was attempted on 


a structure that was not found on the ESCORT 
session file. 


ESC235 SELECTION NOT CURRENTLY 
IMPLEMENTED 


A selection made from the structure menu is not 
implemented for this release. 


ESC236 ILLEGAL SELECTION HAS BEEN MADE 


The selection made does not correspond to the 
selections on the structure menu. 


ESC241 NO STRUCTURES EXIST ON SESSION FILE 


An attempt was made to display or print structure 
names from the session workfile, but no structures 
were found. 
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ESC243 ILLEGAL LENGTH FOR (N) FIELD 
1. An iilegal character was found in the length. 
2. An embedded blank was found in the length. 
3. The length of the N field is zero. 
4. The length of the N field is greater than 15. 


ESC245 INSERTION NUMBER GREATER THAN 
ENTRIES IN STRUCTURE 


The insertion line number is greater than the 
number of entries currently in the structure. 


ESC246 INSERTION NUMBER CANNOT BE ZERO 


The insertion tine number must be a valid line 
number greater than zero. 


ESC266 NO STRUCTURES EXIST ON LIBRARY FILE 
An attempt was made to display or print structure 


names from the ESCORT library file, but no 
structures were found. 
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ESCOO5 RECOVERY/SAVE NAME NOT FOUND IN 
CATALOG 


The filename you specified for session file save or 
recovery was not found in the system catalog. All 
files used in an ESCORT session must be cataloged. 


ESCOO6 FATAL I/O ERROR ON RECOVERY/SAVE, 
OPERATION ABORTED 


A fatal error has occurred during save or recovery of 
the session file you specified. 


Assure that the needed volume is online. Then, if 
this is a save operation and a new file, check the 
VTOC of the volume to be sure there is sufficient 
space for allocation of the file. If both of the above 
are satisfactory, retry the save or recover operation. 
lf the problem recurs, this file cannot be used for 
save or recovery. 


ESCO25 JOB XXXXXXXX CANCELLED; CANNOT 
FIND PROGRAM XXXXXXXX 


No object program exists for program named. 


Enter program named, or remove program from the 
job. 


ESCO26 JOB XXXXXXXX CANCELLED WHILE 
RUNNING PROGRAM XXXXXXXX 


Program named had fatal error. 
Correct program named. 
ESC0O27 PROGRAM TOO LARGE 


Source program exceeds main storage capacity 
allocated by the system. 


If program exceeds main storage allocation by only 
a few characters (50 or less), you can reduce the 
size of the program by combining lines and 
eliminating indentation of lines and punctuation 
characters. Otherwise, you must reduce the size of 
the source program. 


ESC028 LITERAL NOT ENCLOSED WITH DOUBLE 
QUOTES 


Missing double quote character. 
System automatically inserts double quote 


character after last character of literal. If this does 
not correct error, you must correct source program. 


PROGRAM 
MODE 





ESCO29 CANNOT SAVE PROGRAM WITHOUT A 
NAME 


Attempting to save a program without a name. 
Retry command, using a program name. 


ESCO30 NO SOURCE LANGUAGE ENTERED - 
COMMAND CANCELLED 


No source language entered when using the ENTER 
or CHANGE command. if error occurred when using 
the CHANGE command, you probably forgot to move 
the cursor. 


Enter source language and retry command. 


£SCO31 CANNOT FIND SOURCE PROGRAM ON 
WORKFILE - COMMAND CANCELLED 


This error is caused by one of the following: 


1. Changing a source program without a name 
and no RESIDENT program on session file 


2. Saving a source program that does not exist 
on session file. Program name is probably 
misspelled. 


Retry command, using a program name (1) or using 
a program name that exists on the session file. 


ESCO32 CANNOT FIND OBJECT PROGRAM ON 
WORKFILE - COMMAND CANCELLED 


This error is caused by one of the following: 


i: Running an object program without a name 
and no RESIDENT object program on the 
session file 


2. Saving an object program that does not exist 
on the session file. Program name is probably 
misspelled. 


Retry command, using a program name (1) or using 
a program name that exists on the session file. 


ESC033 CANNOT FIND PROGRAM - COMMAND 
CANCELLED 


Source or object program does not exist on session 
file or in ESCORT library. Program name is probably 
misspelled. 


Retry command, using new program name. 


' 
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ESC034 CANNOT WRITE SOURCE PROGRAM TO 
ESCORT LIBRARY 


ESCORT library is full. 
Allocate more main storage for ESCORT library. 


ESCO35 CANNOT WRITE OBJECT PROGRAM TO 
ESCORT LIBRARY 


ESCORT library is full. 
Allocate more disk file space for ESCORT library. 


ESCO36 CANNOT WRITE SOURCE PROGRAM TO 
WORKFILE 


Session file is full. Too many ENTER and CHANGE 
commands were used in the current session. 


Terminate current session and restart another 
session. 


ESC037 CANNOT READ SOURCE PROGRAM FROM 
WORKFILE - COMMAND CANCELLED 


Source program has been found on workfile, but 
unable to read from disk. 


Reenter source program again; then execute 
original command and if same error occurs, contact 
service personnel. 


ESC038 CANNOT READ SOURCE PROGRAM FROM 
LIBRARY - COMMAND CANCELLED 


Source program has been found on library, but 
unable to read from disk. 


Reenter source program again and save; then 
execute the original command and if same error 
occurs, contact service personnel. 


ESCO39 CANNOT FIND JOB NAME ON WORKFILE - 
COMMAND CANCELLED 


Attempting to save a job that does not exist on the 
session file. Job name is probably misspelled. 


Retry command, using a new or corrected job name. 


ESCO040 CANNOT FIND JOB - COMMAND 
CANCELLED 


No job exists by name being used - probably 
misspelled job name. 


Retry command again using new job name. 
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ESC041 CANNOT WRITE JOB TO WORKFILE - 
COMMAND CANCELLED 


Session file is full. Too many ENTER and CHANGE 
commands are used in the current session. 


Terminate current session and restart another 
session. 


ESCO042 CANNOT WRITE JOB TO LIBRARY - 
COMMAND CANCELLED 


ESCORT library is full. 
Allocate more disk file space for ESCORT library. 


ESC043 CANNOT READ JOB FROM WORKFILE - 
COMMAND CANCELLED 


Job has been found on workfile, but unable to read 
from disk. 


Reenter job again; then execute original command 
and if same error occurs, contact service personnel. 


ESC044 CANNOT READ JOB FROM LIBRARY - 
COMMAND CANCELLED 


Job has been found on library but unable to read 
from disk. 


Reenter job again and save; then execute original 
command and if same error occurs, contact service 
personnel. 


ESCO45 CANNOT SAVE JOB WITHOUT A NAME - 
COMMAND CANCELLED 


Attempting to save a job without a name. 
Retry command, using a job name. 


ESCO46 MEMORY NOT AVAILABLE - PROGRAM 
NOT SAVED 


The object program is too large for the current main 
storage allocated; system automatically allocates 
more main storage, but none is available at this 
time. 


Retry command when system is not so busy. 
ESC047 EXCEEDED LIMIT OF FILE NAMES 
You have exceeded the maximum number of files 


(36) aliowed per session. Remove files not being 
used. Then reenter new file names. 
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ESCO048 FILE NAME NOT FOUND 


The file name cannot be found in the password 
table. 


Enter the file name into the password table for this 
session. 


ESCO049 NO PASSWORDS HAVE BEEN ENTERED 
No passwords have been entered for this session. 
Enter passwords. 

ESCO50 NO MEMORY AVAILABLE 
Space for the password table cannot be allocated. 


Retry the command when the system is not so busy. 


ESC117 RECOVERY/SAVE REQUIRES PASSWORD 
ENTER READ OR WRITE PASSWORD XXXXXX 


The file you have specified for session file save or 
recovery is password protected. Enter the necessary 
password for this file in the space provided. 
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ESC119 RECOVERY/SAVE PASSWORD ERROR 
An incorrect password was entered for the file you 
specified for session file save or recovery. Your 
request cannot be processed. 


ESC229 ESCORT LIBRARY LOCKED - SAVE 


OPERATION CANCELLED 
Another user is using the ESCORT library file. 
Wait a few minutes and retry command. 
ESC244 ESCORT LIBRARY FILE LOCK 
Another user is using the ESCORT library file. 


Wait a few minutes and retry the command. 
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ESC247 SCREEN FORMAT ERROR ESC252 FILENAME ALREADY USED 
An error occurred while attempting to read or write The file name you just keyed in was previously used 
a screen format. in this program and is illegal for use here. 

Tutorial mode processing cannot continue; you are Enter the name of a file that has not already been 

returned to command mode. used in this program. 

ESC248 SESSION FILE READ ERROR ESC253 NO DATA RECEIVED - PLEASE REENTER 
An error occurred while attempting to read a A function key was pressed that is not supported by 
program from the session workfile. tutorial mode. Data was expected, but any data 

entered may not have been transmitted. 

Tutorial mode processing cannot continue; you are 

returned to command mode. If you want to call a tutorial supported function by 

using a function key, press the correct function key. 

ESC249 SESSION FILE WRITE ERROR Otherwise, reenter your data and press the XMIT 

key. 

An error occurred while attempting to write a 

program on the session workfile. ESC254 STRUCTURE NAMED ALREADY EXISTS 

Tutorial mode processing cannot continue; you are The alternate structure you chose to create for use 

returned to command mode. with your file already exists. 

ESC250 ESCORT LIBRARY WRITE ERROR Select another structure option or choose another 

name for the alternate structure you will create. 

An error occurred while attempting to save a 

program on the ESCORT library file. ESC255 STRUCTURE NAMED DOES NOT EXIST 

Tutorial mode processing cannot continue; you are The alternate structure you chose to use with your 

returned to command mode. Then enter program file does not exist. 

mode and attempt to save your program. 

Select another structure option or name an existing 

ESC251 NO BUFFER AVAILABLE alternate structure for use with your file. 

Tutorial mode attempted to acquire a buffer from ESC256 NAME INVALID AS ALTERNATE 

the system but none was available. 

You have entered the name of the structure 

Select one of the following to perform the operation associated with your file name when the use of an 

that was interrupted: alternate structure was requested. 

s Save a program ~ Enter program mode and Select the option to use the structure associated 
select the SAVE PROGRAM option from the with your file name or enter a valid alternate 
program commands menu. structure name. 

s Enter a structure - Try again to create your ESC257 PROGRAM ALREADY SAVED - RESELECT 
program (and enter your structure) in tutorial 
mode. You have already saved the program you just 

created. 

If the problem recurs, try again when the system is 

not so busy. Make a different selection from the menu. 


ESC258 ESCORT LIBRARY READ ERROR 


An error has occurred while attempting to read a 
program from the ESCORT library file. 


Tutorial mode processing cannot continue. You will 
be returned to command mode. 
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ESCO08 SYSTEM ERROR XXXX OCCURRED 
ACCESSING FILE XXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXKXAXXXKXKXXXAXKXXKK 


A system error occurred while ESCORT was trying 
to access a data file. 


See Appendix A of OS/3 System Messages 
Programmer/Operator Reference, UP-8076 
(current version) for an explanation of the error 
code. Check to see that the hardware resources 
needed to access this file are available. 


ESCO09 DM nn TYPE nn OCCURRED ACCESSING 
FILE 


An error condition was returned by data 
management on a file access. 


Refer to the OS/3 system messages 
programmer/operator reference, UP-8076 (current 
version) for an explanation and corrective action. 


ESC0O10 PASSWORD PROTECTION ERROR, COULD 
NOT OPEN FILE XXXXXXXXXXXXXXXX 
XXXXKXKKKXXXXKXKXKXXKXKXKXXXXXXKXKXKXXX 


The passwords specified do not allow access to the 
file. 


Supply the correct passwords and retry. 


ESCO11 FILE NOT CATALOGED, COULD NOT 
OPEN XXXXXXXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXKXKXXAXKXKXXK 


The file name specified was not found in the 
catalog. All data files referenced in ESCORT 
programs must be cataloged. 


ESC012 FILE NOT FOUND OR COULD NOT BE 
ALLOCATED, COULD NOT OPEN XXXXXXXXXX 
XXXXXXXXXXAXXXXXXAXKXXKXAXKXXXKXAX KK KKK KK 


The specified file does not exist, or there is no file 
space to allocate the file. 


Correct the file name if misspelled, or make space 
available for file allocation. Retry. 


ESCO13 FILE OPENED WITHOUT WRITE PASS- 
WORD, COULD NOT WRITE TO XXXXXXXXX 
MAKKAH KKKKKK KKK KKKK KK KKK KKK KKK 
XXXXXX 


The write password was not supplied, and the file 
was opened with read only access. 


Supply write password and retry. 
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ESC014 FILE TYPE IS NOT MIRAM, COULD NOT 
OPEN XXXXXXXXXXXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXX 


All data files referenced in ESCORT programs must 
be MIRAM data files. 


ESCO15 DUPLICATE KEY ERROR OCCURRED IN 
ACCESSING FILE XXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXAXXKXKXXXAXXXXXXXKX 


An attempt was made to write a record with the 
same key as an existing record. 


ESCO16 KEY CHANGE ERROR OCCURRED 
ACCESSING FILE XXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXKXKXXXXXKXXXAXAXAXKXK 


A key change during an update was attempted in a 
key that does not allow changes. 


ESCO17 RECORD HAS NO RCB, COULD NOT 
DELETE FROM FILE XXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXAXXXXAXXXXXKXKKKK 


Delete operations can be performed only on 
records with RCBS. 


ESC0O19 KEY MATCH NOT FOUND ACCESSING 
FILE XXXXXXXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXKXX 


A record with the specified key was not found. 


ESCO20 ESCORT INTERNAL ERROR IN ESCSDFOO 
MODULE 


An internal logic error has occurred within 
ESCORT. 


Contact your local Sperry Univac representative. 


ESC021 COULD NOT UPDATE/DELETE RECORD, 
NO PREVIOUS READ FROM FILE XXXXX 
XXXXXXXXXXXXXAXXXKXAXXXKXKXKXXKXXKXKXXKXKXK 
XXXXXXX 


Consecutive update/delete operations were 
attempted without intervening read. 


ESCO22 COULD NOT ACQUIRE DEVICE 
REQUIRED TO OPEN FILE XXXXXXXXXXXXXX 
XXXXXXXXXXKXXXXXXXXKXXAXXKXKXKXXKXKXKK 


The device or volume required to open the 
specified file was not available. The file could not 
be opened. 


Contact the system operator to determine why the 
device or volume was not available. 
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ESC173 SYSTEM MEMORY NOT AVAILABLE 


A buffer was requested from the system, but none 
was available. 


Attempt to recompile the program when the 
system is not so busy. 


ESC174 INPUT/MASTER KEY HAS NO MATCH 


The key value for the input file does not match any 
key values for the master file. 


Correct the program. 

£SC175 WORKSTATION 1/0 ERROR 
An unrecoverable !/O error occurred while trying 
to execute an ENTER, FROM WS, DISPLAY, or 
OUTPUT TO WS clause. 

ESC176 ARITHMETIC RESULT OVERFLOW 
The receiving field in a record is not large enough 
to contain the results of the current arithmetic 


calculation. 


Enlarge the field, or reduce the size of the 
calculation. 


ESC178 SUBSCRIPT EXCEEDS ARRAY MAXIMUM 


During program execution, a subscript has 
exceeded the maximum repeat count for an array. 


ESC179 STACK OUTSIDE OF ALLOWABLE RANGE 


This is an internal ESCORT error. Contact your 
local Sperry Univac representative. 


ESC180 INVALID PROGRAM OBJECT CODE 

This is an internal ESCORT error. 

Contact your local Sperry Univac representative. 
ESC181 INVALID FUNCTION KEY 


The only valid function key for run-time processing 
is F4. 
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ESC190 ERROR OCCURRED WHILE ATTEMPTING 
TO USE THE SCREEN FORMAT FOR INPUT DATA 


ESCORT has encountered a screen format error. 


A screen containing additional information is 
displayed with this message. 


ESC191 ERROR OCCURRED WHILE ATTEMPTING 
TO USE THE SCREEN FORMAT FOR CHANGE DATA 


ESCORT has encountered a screen format error. 


A screen containing additional information is 
displayed with this message. 


ESC192 ERROR OCCURRED WHILE ATTEMPTING 
TO USE THE SCREEN FORMAT FOR OUTPUT TO WS 


ESCORT has encountered a screen format error. 


A screen containing additional information § is 
displayed with this message. 


ESC193 ERROR OCCURRED WHILE ATTEMPTING 
TO USE THE SCREEN FORMAT FOR OUTPUT TO WS 


ESCORT has encountered a screen format error. 


A screen containing additional information is 
displayed with this message. 


ESC194 KEYS INCONSISTENT WITH KEY 
POSITION/LENGTH ON FILE 


The key position or length specified in the file 
structure does not match the key position or length 
on the file as found when the file was opened. 


ESC195 FILE XXXXXXXXXXXXXXXXXXXX 
XXXXXXXXXXXXKXXXAXAXXXXXAXAXX STRUCTURE 
SIZE GREATER THAN MAXIMUM RECORD SIZE 


The structure you have used with the specified file 
is larger than the records in the file. 


Correct the structure to be no larger than the 
records, or use another structure of correct size 
and format for the file. 
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Appendix F. SYSGEN Requirements 
and System Considerations 


F.1. SYSGEN REQUIREMENTS 


You must specify the following SYSGEN options when you use 


ESCORT: 
System 80 Series 90 
x 
Xx 
x 
x 











Maximum timer services 





Resident tasking support 
Spooling 
File lock 
cdl 


Shared code support 










Dynamic buffer management 


ISKEY 


Featured instruction 
set 


If you use the EXPREGION and RESBUFSIZ keyword parameters, do 
not specify EXPREGION=0 and RESBUFSIZ=(some large value). This 
causes an error when used with ESCORT. Instead, specify 
EXPREGION=20000 and use the default for RESBUFSIZ (500 bytes). 


A 
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F.2. EFFICIENCY RECOMMENDATIONS 


1. Make sure ESCORT modules are resident. Generate the system 
that way or specify it during IPL. 


2. Place files carefully. Avoid the RES pack, and place COBOL 
work files and ESCORT files on different packs, if possible. 


3. Avoid using the console. 


F.3. CODING RESTRICTIONS 


It is not possible to code ESCORT programs using the General Editor 
(EDT) because EDT uses variable-length records and ESCORT uses 
fixed-length records. 4 
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of example: 
system utility 
fields 


Custom 
structures 


Allocating 
temporary 
storage 


Initializing 
fields 


SPERRY UNIVAC OS/3 G-1 
ESCORT 








Appendix G. Custom Formatting 
Using Structures 


The following example (Figure G-1) uses custom structures to 
custom-format output. The example reads a file, prints a heading 
on each page of output, lists detail lines, and prints a subtotal for 
each customer. 


SLINE and $PAGE, the system utility fields specified, control the 
spacing and page breaks in the example. You can test these fields 
and set them to different values. They increment automatically. 
They have a value of zero initially and must be set to a value other 
than zero to start the internal counter. In the program, $PAGE is 
initialized to 1 in the IF FIRSTIME clause. $LINE is set to 1 during 
the first cycle of the program (when $LINE equals 0) or when the 
line count is greater than 50. Setting S$LINE to 1 causes a top-of- 
page and printing of, in this case, the heading, beginning on the 
line specified. 


The structures EO8HD, EO8DETL, and EO8STOT are custom 
structures. EO8HD uses dummy fields (the FIL fields) to space the 
data. In EO8DETL and EO8STOT, the starting position for the field is 
specified when the structure is entered, eliminating the need for 
the dummy fields. This method allows fields with edit codes and V 
or P type numeric fields to be expanded. 


The WORKAREA clause allocates temporary working storage space 
and initializes values of data fields not defined in the master or 
input files. All fields are initialized to blanks (alphanumeric fields) 
or zeros (numeric fields). When a field is to have a value other than 
blank/zero, setting it equal to that value initializes the field. In this 
example, the structure EO8WK contains those fields not found in 
EO8TIME that are referenced in the custom structures for output, 
and fields used for comparison and calculations. The title and 
column headings are also initialized here. Values for the other 
fields are computed later in the program. 


Note that the key of the file is redefined; that is, a starting position 
was specified when the structure was created, and another field 
(or fields) occupies the same position. 
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SELECT DATA OF EOSTIME 

WORKAREA(EG@8WK) HI="‘DATE: °'. TITLE="‘CUSTOMER TIME’'’. H2='"PAGE: 
H3=""CUSTOMER'’, H4='‘CUSTOMER’’, H5=‘‘NUMBER''. H6='‘NAME'', H7='‘DATE'’. 
H8="‘LENGTH''’, H9=‘'TOTAL TIME IS: 

IF FIRSTIME COMPUTING RPTDATE=$DATE, SAVNO = CUSTNO, S$PAGE = 1 END 
IF CUSTNO < > SAVNO COMPUTING S$LINE = $LINE - 1 

OUTPUT TO PRINTER(E@8STOT) 

COMPUTING SAVNO = CUSTNO, SUBTOT = 8, SLINE = $LINE + 2 END 

tF $LINE = 6 OR SLINE > 58 

COMPUTING SLINE = 1, PAGE = $PAGE 

OUTPUT TO PRINTER(E@8HD) END 

COMPUTING SUBTOT = SUBTOT + LENGTH 

OUTPUT TO PRINTER(ES8DETL) 

1F ENDOFILE COMPUTING SLINE = $LINE + 1 

OUTPUT TO PRINTER(E@8STOT) END 





a. Display of program EO8TIME 





..rrti‘iéO 








DISPLAY STRUCTURE EBSTIME TOTAL LENGTH 0626 
LENGTH/ EDIT REPEAT 

FIELDNAME TYPE KEYS CODES COUNT POSITION 

CUSTNO 5N 081 - 8065 
DATE 6N 6096 - 8011 
NODT 11N Kl 6081 ° 0811 
CUSTNAME 18A 9812 - 8821 
LENGTH 3V2 9622 - 0626 


b. Structure EO8TIME 


Figure G—1. Example of Custom Formatting Using Structures (Part 1 of 6) 
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FIELDNA 


Hl 
RPTDATE 
Flil 
TITLE 
FIL2 
H2 
PAGE 
FIL3 
FIL4 
FILS 
H3 
FILE 
H4 
FIL7 
FIL8& 
H5 
FILS 
H6 
FILIB 
H7 
FILI1 
H8 
FiLl2 
FIL13 


CUSTNO 
CUSTNAM 
DATE 
LENGTH 
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DISPLAY STRUCTURE E@8HD 


LENGTH/ EDIT 
ME TYPE KEYS CODES 


6A 
8A 


c. Structure EO8HD 


DISPLAY STRUCTURE EO8DETL 
LENGTH/ EOIT 


SN 
E 
6N 


d. Structure EO8DETL 


TOTAL LENGTH 


REPEAT 
COUNT 


TOTAL LENGTH 


REPEAT 
FIELDNAME TYPE KEYS CODES COUNT 


G-3 





6791 


POSITION 


6681 
8687 
9015 
6831 
0044 
6868 
8973 
0877 
8132 
9396 
0462 
6410 
8419 
0427 
9528 
0534 
65408 
6551 
6555 
0576 
0588 
0587 
9593 
0668 


BH64 


POSITION 


8887 
0824 
8849 
0868 


6811 
8033 
6654 
6864 


8066 
0814 
6838 
8843 
8067 
6072 
0976 
§131 
6395 
6401 
9469 
6418 
0426 
6527 
6533 
8539 
6558 
0554 
9575 
0579 
9586 
9592 
6659 
8791 








Figure G—1. Example of Custom Formatting Using Structures (Part 2 of 6) 
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DISPLAY 





STRUCTURE 





E@8STOT 





TOTAL LENGTH 8836 












LENGTH/ EDIT REPEAT 
FIELDNAME TYPE KEYS CODES COUNT POSITION 














H9 16A 6814 - 80829 
SUBTOT 5¥2 2 86368 - 08836 





e. Structure EO8STOT 


DISPLAY STRUCTURE E88WK TOTAL LENGTH #181 


LENGTH/ EDIT REPEAT 
FIELDNAME TYPE KEYS CODES COUNT POSITION 


H1 6A 0801 8006 
TITLE 13A 0007 0819 
H2 6A 0028 0825 
H3 8A 0826 6833 
H4 8A 0834 0841 
H5 6A 6842 0847 
H6 4A 0848 6851 
H7 4A 8052 0855 


H8 6A 8056 0861 
H9 16A 8062 8077 
RPTDATE 8A 6878 8085 
PAGE 4n 8086 0089 
SUBTOT 5v2 00998 8096 
SAVNO 5N 8697 6161 





f. Structure EO8WK 


Figure G—1. Example of Custom Formatting Using Structures (Part 3 of 6) 
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DATA OF EGSTIME 


CUSTNO DATE CUSTNAME LENGTH 


860118 AAAAAAAAAA 
866126 AAAAAAAAAA 
816181 AAAAAAAAAA 
866165 BBBBBBSBBB 
868115 SBBBBBBBBB 
866169 cccccccecce 
886121 ODDODDODDD 
869122 DDDDDDODDD 
8686325 DODDDDDODD 
868712 ODDDDDDDDD 
881181 DODDODDODD 
818106 DDDDDODDDD 
818623 EEEEEEEEEE 
816213 FRFFFFFFFF 
8186384 FEFFFFFFFE 
818325 FEFFRRFFFFF 
881828 GGGGGGGGGG 
861265 GGGGGGGGGG 
881218 GGGGGGGGGG 
810414 HHHHHHHHHH 
816513 HHHHHHHHHH 
816161 Hoeegbeeee 
816363 Pobeegededd 
816481 badeebten 
806564 SISIIISIIIS 
818362 JISIISIISS 
819589 JISIISIIIS 
819681 JISSIISIIS 
810602 JSISISIISS 
816603 JIISSIIIIIS 
810604 JISSISIISS 
810685 JISSIISIISS 
818696 JISIIISISIIS 
810667 JddIIISSIII 
818668 JIIIIIIII 
818669 JISIIISIIS 
816618 JdSIIISIINS 





g. List of data for program EO8TIME 


Figure G-1. Example of Custom Formatting Using Structures (Part 4 of 6) 
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DATE: 82/03/85 
CUSTOMER 
NUMBER 


89881 
80881 
68081 





CUSTOMER TIME 


CUSTOMER 
NAME 


AAAAAAAABA 
AAAAAAAAAA 
AAAAAAAAAA 


TOTAL TIME IS: 


BBBBBBBBBB 
BBBBBBBBBB 


TOTAL TIME i$: 
ceccceccecce 
TOTAL TIME IS: 
DODDDODDDD 
DDDDODODDD 
ODDDDDDDDD 
ODDDDDODDD 
DDDODDDDDD 
ODDODDDDDD 
TOTAL TIME IS: 
EEEEEEEEEE 
TOTAL TIME IS: 
FREFFFFFFE 
FREFFEFFFF 
FEFFFFFFFF 
TOTAL TIME 1S: 
GGGGGGGGGG 
GGGGGGGGGG 


GGGGGGGGGG 


TOTAL TEME IS: 


DATE 


88/81/10 

88/81/28 

81/81/81 
30.88 


80/81/65 
88/81/15 


20.08 
88/81/89 
160.08 
88/61/21 
88/81/22 
88/83/25 
88/87/12 
88/11/81 
81/61/06 
68.60 
81/06/23 
18.80 
81/02/13 
81/63/84 
81/63/25 
36.08 
88/18/28 
88/12/85 


88/12/16 


308.68 








PAGE: 6801 


LENGTH 


Printout for program EO8TIME, Page 1 


Figure G—1. Example of Custom Formatting Using Structures (Part 5 of 6) 
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DATE: 82/83/85 CUSTOMER TIME PAGE: 0682 


CUSTOMER CUSTOMER 
NUMBER NAME DATE LENGTH 


68088 HHHHHHHHHH 81/84/14 10.08 
068088 HHHHHHHHHH 81/85/13 10.68 


TOTAL TIME IS: 08 


Hibbdeteed 81/01/81 
Tabbed iuedl 81/63/83 
PLUberiide 81/84/01 


TOTAL TIME IS: - 08 


SSSJISIIII 88/85/04 
JSIIIISIIIS 81/83/82 
JJSIIIISII 81/85/89 
JSJSIIIIIIIS 81/06/81 
JJddIIIISI 81/66/82 
SJSIIIIIISS 81/86/03 
JIIIIIIIIS 81/06/84 
JSISIIIIIIS 81/86/85 
JSISSISIIIISS 81/86/86 
JISSIIIISS 81/06/87 
JSISSIIIIISS 81/86/08 
JSISIIIISS 81/86/89 
SIIISSIIIIS 81/06/18 


TOTAL TIME IS: 138.68 





i. Printout for program EO8TIME, Page 2 


Figure G—1. Example of Custom Formatting Using Structures (Part 6 of 6) 
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Glossary 
A D 
array data 
Adjacent fields of similar data (e.g., the months in a Facts that are organized in a formalized manner and 
year) that occur several times and have the same are suitable for communication and processing. 
length for each occurrence (e.g., 3-letter 
representations for each month: JAN, FEB, MAR, 
etc). direct entry method 
The program mode method that lets you key 
program statements directly onto a blank screen. 
Cc 


character string operators 
Words that let you set conditions on a field by 
specifying an alphanumeric string of data. For 
example, IF FIELDA STARTS WITH “DOG”. 


clauses 
The part of program statements that lets you 
describe to ESCORT the specific operations you 
want to perform on your data file. 


commands 
The part of ESCORT that lets you tell ESCORT what 
operation you want to perform on your programs, 
structures, and jobs. 


compile 
The method by which ESCORT checks the syntax of 
your program statements and translates them into a 
language the computer can understand. 


consolidated data management 
The data access method used by ESCORT that is set 
by your system administrator at system generation 
time. 


constants 
Those values assigned to data fields that do not 
change during program execution. 


E 

edit codes 
A set of symbolic editing codes you designate in 
your structure that perform certain functions on 
numeric fields. 

F 

field 
The smallest unit of an ESCORT file. Each field 
holds an individual piece of data. 

field name 
A 1- to 8-alphanumeric-character designation you 
assign to identify each field of a record in your file. 

file 


A group of related records taken as a whole. 
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H 

HELP 
The ESCORT facility that explains the function of 
the segment in which you request help. 

I 

index keys 
Keys that designate fields in your structure that you 
use to sort your data into meaningful order. These 
also designate the matching criteria when defining 
the file to the system. See also sort keys. 

indexed file 


A file organized in a logical manner with data 
records and a set of record keys that point to each 
data record. 


interactive program mode 
The ESCORT operating mode you'll use after you 
learn ESCORT by using interactive tutorial mode. 


interactive tutorial mode 
The operating mode that teaches you how to use 
the ESCORT language. 


J 

job 
A group of related programs that are executed 
sequentially. 

K 

keys 


(See sort keys and index keys.) 
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LENGTH/TYPE 
A structure statement parameter that designates 
how long and what type of data fields are in your 
record. 


library 
An area on your disk where ESCORT programs, 
structures, and jobs are stored following a SAVE 
operation. 


logical operator 
Words you use to link one or more conditional 
statements. The two logical operators are OR and 
AND. 


LOGON command 
The OS/3 interactive services command that lets 
you gain access to the workstation and the system. 


matching criteria 
Structure fields designated as index key fields or 
matching fields. 


matching sorted 
A type of matching criteria you use for an unkeyed 
file. It tells the system the file is arranged in 
ascending order according to that data field. 


matched unsorted 
A type of matching criteria you use for an unkeyed 
file. It tells the system the file is not arranged in any 
particular order. 


MIRAM (multiple indexed random access method) 
The file type used by ESCORT. 
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nonindexed file 
A file organized sequentially. This means the 
records appear on the file in the order you enter 
them. 


program 
A collection of program statements and clauses 
that perform operations on your data files. 


program statement 
One of five statements that describe generally the 
operation you want to perform on your files. 


record 
A group of data fields relating to a specific item. 


relational operator 
A set of arithmetic type operators that regulate the 
entry, change, or selection of your data. 


repeat count 
The structure parameter that lets you specify the 
number of times an array field is repeated in the 
record. 


reserved words 
All words used in the ESCORT language. This 
means you can’t use them as file or field names, 
but you can use them as constants or in data 
fields. 


RESIDENT (program or job) 
The default name that ESCORT assigns when you 
enter or change an unnamed program or job. 
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screen format coordinator 
The component of screen format services that 
coordinates the transfer of input and output data 
between your program and your form. 


screen format generator 
The component of screen format services that 
allows you to create screen forms from the 
workstation. - 


screen format services 
The OS/3 component that allows you to create 
customized input and output forms to use with your 
ESCORT program. 


screen menu method 
The program mode method that lets you use a 
series of menus to build your program. 


session file 
A disk file where everything you enter or change is 
contained. This file is only accessible during your 
current session and afterwards only if you name 
and save it. 


sort keys 
Keys that designate fields in your structure that you 
designate to sort your data into meaningful order 
(e.g., alphabetically, by account number, etc). 


start position 
The structure statement parameter that lets you 
designate where in the record you want a certain 
field or fields to appear. 


structure 
The collection of structure statements through 
which you tell ESCORT what your file looks like by 
defining each field in the record with a structure 
statement. 


structure statement 
The statement through which you define a field ina 
record by specifying the field name, length, and 
type. 


system bulletin 
The bulletin that gives you information about the 
operation of your system. It is displayed after you 
key in the LOGON parameters. 
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utility fields variable name qualifiers 
A group of fields supplied and used by the system Qualifiers that tell the system what file structure a 
that perform often used operations. specified field is from. This is helpful when you 


have more than one structure with the same field 
name referenced in your program. 
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Index 
Term Reference Page Term Reference Page 
A Assumed decimal fields 
Allocating file space can e oe = 
allocating files for ESCORT 6.3 6-3 . ; 
: sign handling 6.6 6-8 
alternate job control stream 6.3 6-4 structure. renceselitalion 6 6 6-9 
calling general editor (EDT) 6.3 6-3 , 
sea control stream to 63 6-4a Asterisks in overlay structure fields 6.7 6-15 
creating the file 6.3 6-4a 
ESCORT library 6.3 6-4a 
executing job control stream 
& from ESCORT 6.3 6-4 
job control stream for System 80 6.3 6-4 
sample interactive services 
ALLOCATE command 6.3 6-3 
sample job control stream 6.3 6-4 
Alphanumeric fields B 
examples 6.6 6-7 
length 6.6 6-7 Binary fields 
structure representation 6.6 6-7 examples 6.6 6-10 
length 6.6 6-10 
Alternative parameter choices sign handling 6.6 6-10 
program statement format conventions 7.2 7-3 Storage requirements 6.6 6-10 
screen format conventions 1.5 1-13 structure representation 6.6 6-10 
Arithmetic conventions D.1 D-1 Braces, program statement format 
conventions 7.2 7-3 
Arithmetic operators 
definition Appendix D Brackets, program statement format 
types allowed Appendix D conventions 7.2 7-3 
use of parentheses Appendix D 
BY clause 
Array fields format 7.17 7-20 
detined 6.7 6-13 parameters 7.17 7-20 
example 6.7 6-14 program statement and clause 
referencing in a program 6.7 6-14 cross-reference Table 7-1 7-2 
specifying in a structure 67 6-14 use 7.17 7-20 
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Term 


Calling ESCORT 
menu choices 
starting a session 


Capital letters 
program statement format conventions 
screen format conventions 


Cataloging files 
description 
in an ESCORT session 


sample job contro! stream 


Change data by assigning new field values 
(program mode) 

CHANGE DATA statement 
clause decisions 
clause selection 
completed CHANGE DATA screen 
COMPUTING clauses 
example program 
initiation of CHANGE DATA 
parameter keyin 
PRINT clause 
program compilation 
program display 
program execution 
program objective 
SAVE PROGRAM option 
select COMPUTING clause 
selecting the COMPUTING clause 
standard system output format 
statement completion 
structure-name, formname parameter 
structure-name parameter 


Change data from the workstation 
(program mode) 

clause decisions 
example definition 
initiation of CHANGE DATA 
keyed files 
parameter keyin 
program display 
program execution 
required parameters 
statement compilation 
statement completion 
unkeyed files 


Change data of master file by replacing 
with matching file data 
additional clause selection 
CHANGE DATA program statement 
choosing the PRINT option 


Reference 


2.3 
2.3 


72 
15 


6.3 
3.2 
4.2 
6.3 


4.9 
4.9 
4.9 
4.9 
49 
49 
4.9 
4.9 
49 
49 
4.9 
49 
49 
49 
49 
49 
49 
49 
49 
49 


48 
48 
48 
48 
48 
48 
48 
48 
48 
48 
48 


4.10 
4.10 
4.10 
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4-19 
4-20 
4-2] 
4-20 
4-21 
4-23 
4-19 
4-19 
4-22 
4-22 
4-23 
4-23 
4-19 
4-22 
4-2] 
4-20 
4-23 
4-22 
4-19 
4-19 
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4-26 
4-25 
4-26 
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Term 


clause decisions 

creating a transactional file 
INVNTORY structure 
INVTRAN structure 

name the program 
parameters 

program compilation 
program display 

program example 

program execution 

program results 

sample program, INVNTORY 
sample program, INVTRAN 
saving the program 
selecting the COMPUTING clause 
statement completion 

using transactional files 


CHANGE DATA program statement 

basic format 

basic statement 

change data by assigning new field 
values 

change data by replacing with 
matching file data 

change data from the workstation 

format 


related clauses 
use 


CHANGE JOB command 
named jobs 
purpose 
unnamed jobs 


CHANGE PROGRAM command 
named programs 
purpose 
unnamed programs 


CHANGE STRUCTURE command 
action 
purpose 


Changing data from the workstation 
(tutorial mode) 

compiling your program 
example 
executing the program 
method for keyed files 
method for unkeyed files 
name the file to be changed 
naming programs 
printing changed data 
printing selected 


Index 2 


Reference 


4.10 
4.10 
4.10 
4.10 
4.10 
78 

4.10 
4.10 
4.10 
4.10 
4.10 
4.10 
4.10 
4.10 
4.10 
4.10 
4.10 


77 
78 


49 


4.10 
48 
77 
Al 
7.6 
78 
76 


9.25 
9.25 
§.25 


5.4 
5.4 
9.4 


5.15 
5.15 


3.7 
3.7 
3.7 
3.7 
3.7 
3.7 
3.7 
3.7 
3.7 


Page 


4-25 
4-23 
4-24 
4-24 
4-25 
7-10 
4-26 
4-27 
4-27 
4-27 
4-28 
4-24 
4-24 
4-27 
4-25 
4-26 
4-24 
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ESCORT 
Term Reference Page Term Reference Page 
Changing data from the workstation program makeup 9.3 5-4 
(tutorial mode) (cont) program statement choice 5.1 5-2 
program listing 3.7 -14 Selection 9.1 sl 
sample output 37 “16 selection menu 5.1 5-1 
selecting the change method 37 structure 9.14 5-10 
ieriiinating ‘the change 37 structure command selection 5.14 5-10 
STRUCTURE COMMANDS menu 5.14 5-10 
Character string operators 7.34 7-40 Strustury.maheup at oy 
use 5.1 5-1 
Clauses . 
BY 1 7-20 Compile 3.5 3-8 
CLEARING 7.18 7-21 : ; 
COMPUTING 7.19 7-22 Compiler error messages Appendix E 
: 7- 
EREATING oe ef COMPUTING clause 
DISPLAY 7.21 7-25 
END 7.22 7-26 example: data replacement statements 7.19 7-22 
EXIT 723 7-97 format 7.19 7-22 
EXTENDING 7.24 7-28 patarneters 7.19 1-22 
function 7.16 7-19 URE 7.19 1-22 
how to find i al 7.16 7-19 
Pai a 725 7-29 Concepts of ESCORT 
PRINT 7.27 7-32 how ESCORT works 14 1-7 
SUBTOTALING 7.28 7-33 : 
TOTALING 7.29 7-35 Consolidated data management 
UPDATING 7.30 1-36 data access method used by ESCORT 2.1 2-1 
USING 731 1-37 Series 90 2.1 2-1 
WHILE 7.32 7-38 System 80 2.1 2-1 
WORKAREA 7.33 7-39 Gindias 
d with tat t 7.1 7-1 
used with program statements 6 9 definition D1 D-1 
CLEARING clause types allowed DJ D-1 
example: clearing alphanumeric fields 7.18 7-21 ; : 
example: clearing numeric, decimal, Creating 4 data file (tutorial mode) 
packed, and binary fields 7.18 7-21 pefeduisne J5 Say 
format 7.18 7-21 saeelial 3.5 3-4 
parameters 7.18 7-21 specifying file name 3.5 3-5 
ee 7.18 7-21 using a new structure 3.5 3-5 
; using alternate structures 3.5 3-5 
Coding restrictions F.3 F-2 See also data entry. 
Coimmarids Creating a new data file (program mode) 
choosing command type Fig 1-1 1-8 additional file processing 45 4-8 
Fig. 1-2 1-12 Clause decisions 45 4-7 
Aetied 13 1-7 CREATING clause 45 4-7 
ENTER PROGRAM 51 5-2 default record format for data entry 45 4-9 
example use: programs 5] 5-] ENTER DATA program statement 45 4-6 
io 5 24 5-17 entering data 45 4-6 
job command selection 5.24 5-17 example i pl 4.9 4-8 
JOB COMMANDS menu 5.24 5-17 file and structure names 45 4-7 
job makeup 5.24 5-17 input termination 45 4-10 
other command types 5.1 5-2 Seep a - 
password commands 5.35 5-21 Popa ee : 
program 53 5-4 program execution 45 4-9 
program command selection 5.3 5-4 sample input a = 
5-4 saving a program 45 4-8 


PROGRAM COMMANDS menu 


5.3 
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Term 


Creating a new data file (program mode) 
(cont) 


specifying output file and structure 
names 

statement completion 

structure-name, formname parameter 

structure-name parameter 

terminate ESCORT session 

terminate program mode 


CREATING clause 
file name attributes 
format 
larger file names 
parameters 
use 


Data change 
by assigning new field values 
by replacing with matching file data 
from the workstation 
in tutorial mode 
using screen menu method 
(program mode) 


Data entry in program mode 


Data entry in tutorial mode 
additional data 
entering data 
example 
moving from field to field 
sending data to the system 
terminating 


Data files 
files sharing guidelines 
files written in another language 


Default menu selections 


Default record format for data entry 


Reference 


45 
45 
45 
45 
45 
45 


7.20 
7.20 
7.20 
7.20 
7.20 


4.9 
4.10 
48 
3.6 


47 


See creating 
a new data 
file (program 
mode). 


3.5 
3.5 
3.5 
3.5 
3.5 
3.5 


D.5 
D.4 
3.3 


46 





SPERRY UNIVAC OS/3 


Page 


4-19 
4-23 
4-14 
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Term 


Delete data based on IF conditions 
DELETE DATA statement 
example definition 
example program 
parameter keyin 
program compilation 
program display 
program execution 
program results 
purpose 
statement completion 


Delete data by file matching 
creating transactional files 
DELETE DATA statement 
example definition 
example program 
parameter keyin 
program action 
program compilation 
program display 
program execution 
program results 
statement completion 


Delete data by workstation inquiry 
DELETE DATA parameters 
DELETE DATA statement 
example definition 
example program 
initiation of DELETE DATA 
keyed file deletion prompt 
parameter keyin 
program display 
program execution 
program results 
record number to be deleted 
statement completion 


DELETE DATA program statement 
delete data based on IF conditions 
delete data by file matching 
delete data by workstation inquiry 
format 


parameters 
screen menu, program mode 
uses 


Deleting data (tutorial mode) 
deleting the record 
keyed files 
purpose 
selecting method of deletion 
terminating the deletion operation 


Index 4 


Reference 


4.18 
4.18 
4.18 
4.18 
4.18 
4.18 
4.18 
4.18 
4.18 
4.18 


4.17 
417 
4.17 
4.17 
4.17 
4.17 
4.17 
4.17 
4.17 
4.17 
4.17 


4.16 
4.16 
4.16 
4.16 
4.16 
4.16 
4.16 
4.16 
4.16 
4.16 
4.16 
4.16 


4.18 
4.17 
4.16 
7.15 
A.2 

7.15 
4.15 
7.14 


3.12 
3.12 
3.12 
3.12 
3.12 
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4-50 
4-50 
4-5] 
4-50 
4-5] 
4-51 
4-51 
4-51 
4-50 
4-5] 


4-48 
4-48 
4-48 
4-49 
4-48 
4-49 
4-48 
4-49 
4-49 
4-50 
4-48 


4-46 
4-46 
4-45 
4-47 
4-45 
4-47 
4-46 
4-47 
4-4] 
4-47 
4-47 
4-47 


4-50 
4-48 
4-45 
7-17 
A-2 

7-17 
4-45 
7-17 
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E 
Direct entry method 
advantages % i Fait ‘codes 
; 1 function 6.7 6-13 
intended user - acs symbols and functions 6.7 6-13 
selection i He Table 6-1 6-13 
END clause 7.22 7-26 
Direct entry of clauses 
eee oa ENTER DATA program statement 
SERED: basic format 74 7-5 
basi t 75 7-6 
Direct entry of program statements oe 15 1-6 
choosing direct entry of statements 4.22 4-58 complete format 74 1-5 
direct entry example 4.22 4-58 A3 A-2 
how to access 4.22 4-58 siaingle 15 1-6 
keyin format 4.22 4-59 esaviole’ Goan 75 7-7 
program length 4.22 4-58 ‘ prog ; 7 
format 422 4-58 example structures 75 -6 
opeen : format 75 7-6 
DISPLAY clause parameter uses 75 7-6 
ens 121 1-25 parameters 75 7-6 
naraietels 721 1-25 related clauses 7.3 7-4 
use 7.21 7-25 = ce oo 
DISPLAY JOB command ENTER DATA program statement 
i (program mode) 
named jobs 5.26 -18 
‘sae 5 26 18 creating a new data file 45 4-6 
pec hg 526 18 data entry methods 44 4-6 
; extending an existing data file 46 4-1] 
DISPLAY JOB NAMES command 5.27 5-18 ENTER DATA program statement 
(tutorial mode) 
DISPLAY PASSWORDS command 5.36 5-22 creating a data file 35 3-4 
DISPLAY PROGRAM command optinns a4 ae 
famed propane 55 5-5 options selected 3.4 3-4 
BllFBOSe 55 5-5 purpose 3.4 3-4 
unnamed programs 5.5 5-5 ENTER JOB command 
DISPLAY PROGRAM NAMES command aed Jobs sae 
EAE 56 5-5 purpose 5.28 
ibeaty: tynes 56 5-5 unnamed jobs 5.28 
purBgse 28 = ENTER OR CHANGE PASSWORDS command 537 5-23 
DISPLAY te command ne is ENTER PROGRAM command 
aun 516 5-1] named programs 5.7 5-5 
PUIDESE ; purpose 57 5-5 
J 5- 
DISPLAY STRUCTURE NAMES command 5.17 5-12 HAM Ean eran ? : 
ENTER STRUCTURE command 
action 5.18 - 
enter structure screen 5.18 
purpose 5.18 - 
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Term Reference Page Term Reference Page @ 
Error messages F 
compiler errors Appendix E 
compiler syntax errors Appendix E Field 
program mode errors Appendix E defined 6.1 6-1 
run-time errors Appendix E kinds 6.1 6-1 
structure errors Appendix E names 6.6 6-6 
tutorial mode errors Appendix E 6.8 6-15 
system utility 6.9 6-17 
EXIT clause Table 6-2 6-17 
format 7.23 7-27 
use 7.23 7-27 FIELDNAME 
examples 6.6 6-6 
Extending an existing data file format 6.6 6-6 
(program mode) identifying the data 6.6 6-6 
additional clause choices 46 4-11 required part of structure statement 6.6 6-6 
choosing ENTER DATA statement 4.6 4-10 restrictions 6.6 6-6 
default record format for data entry 46 4-13 
ENTER DATA statement 4.6 4-10 Files 
entering data records 46 4-13 allocating space 6.3 6-3 
example program 46 4-12 cataloging the file 6.3 6-3 
file and structure name entry 46 4-11 defined 6.1 6-1 
file extension complete 46 4-13 example 6.1 6-1 
naming the output file 46 4-11 handling uncataloged files 3.2 3-2 
program compilation 46 4-12 indexed files 6.2 6-2 
program display 46 4-12 nonindexed files 6.2 6-2 
program execution 46 4-13 types 6.2 6-2 
purpose 46 4-10 
saving a program 46 4-12 Forms 
selecting the EXTENDING clause 46 4-11 concept 9.1 9-1 
statement completion 46 4-11 customized screen format 9.4 9-4 
9-7 9-7 
EXTENDING clause Appendix G 
format 7.24 7-28 default screen format 9.4 9-4 
parameters 7.24 7-28 example of ESCORT structure/form 
selecting 46 4-11 linkup 9.5 9-5 
use 7.24 7-28 guidelines for printing 
custom forms 9.7 9-7 
ESAF 5.2 §-3 how to link your ESCORT program 
5.6 5-5 to a screen form 9.4 9-4 
5.13 5-8 rules for screen forms 9.4 9-4 
screen format services functions 9.1 9-1 
ESC) 5.2 5-3 screen format services 9.2 9-2 
5.6 5-5 9.3 9-3 
5.34 5-21 screen forms 9.1 9-1 
special ESCORT considerations 9.6 9-6 
E$CO 5.2 5-3 using input screen forms 9.1 9-1 
5.6 5-5 using output screen forms 9.1 9-2 
5.13 5-8 
Function key use Appendix C 
ESCS 5.2 5-3 
5.6 5-5 
5.13 5-8 
ESFD 5.2 5-3 
5.6 5-5 
5.23 5-16 
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& Term Reference Page Term Reference Page 
H limitations 12 1-3 
method of operation 12 1-3 
HELP options after terminating 3.5 3-9 
HELP screen 12 1-3 purpose 3] 3-1 
14 1-13 purpose of screens 3.1 3-1 
2.3 2-4 result of choosing 1.4 1-12 
3.1 3-1 terminating tutorial mode 3.5 3-9 
sample structure HELP screen 6.13 6-23 
structure HELP facility 6.13 6-23 
| 
J 
IF clause 
conditions and special operators used 7.34 7-40 Job 
examples 7.25 7-29 advantages 8.1 8-1 
format 7.25 7-29 CHANGE JOB screen 8.3 8-3 
parameters 7.25 7-29 command initiated action 8.4 8-4 
use 7.25 7-29 command selection menu 8.2 8-2 
completed ENTER JOB screen 8.2 8-3 
& Indexed files definition 13 1-7 
organization 6.2 6-2 8.1 8-1 
sort keys 6.7 6-10a difference between job and program 8.1 8-1 
ENTER JOB screen 8.2 8-2 
INSERT INTO STRUCTURE command 5.19 5-13 how to change 8.3 8-3 
how to enter 8.2 8-2 
Interactive program mode JOB COMMANDS menu 8.2 8-2 
advantages 41 4-} 8.4 8-4 
command selection 42 4-3 making changes permanent 8.3 8-4 
direct entry method 12 1-5 processing your job 8.2 8-3 
41 4-1 selection action 8.4 8-4 
entry methods 4] 4-] using commands to manipulate 8.4 8-4 
intended user 1.2 1-4 ways to use 8.1 8-1 
41 4-1 
methods of operation 1.2 1-4 Job commands 
screen menu method 1.2 1-4 CHANGE JOB 5.25 5-17 
4.1 4-] DISPLAY JOB 5.26 5-18 
structure entry 42 4-3 DISPLAY JOB NAMES 5.27 5-18 
ENTER JOB 5.28 5-18 
interactive tutorial mode menu 5.24 5-17 
default selections 3.3 3-3 8.2 8-2 
effect of selection 3.1 3-1 PRINT JOB 5.29 5-19 
entering 2.3 2-4 PRINT JOB NAMES 5.30 5-19 
3.3 3-2 REMOVE JOB FROM LIBRARY 5.32 5-20 
entering data 3.5 3-9 REMOVE JOB FROM WORKFILE 5.31 5-19 
file handling 3.2 3-2 result of choosing 1.4 1-11 
function selection 3.3 3-3 RUN JOB 5.33 5-20 
how to enter 3.2 3-2 SAVE JOB 5.34 5-21 
& 3.3 3-2 TERMINATE CURRENT ESCORT SESSION 
initial menu 3.3 3-3 JOB 5.39 5-24 
intended user 12 1-2 
3.1 3-1 Job control stream 6.3 6-4 
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Term 


Keyed files 
example 
keyed file display prompt 
keyed file record display 


Keyins, how indicated 
Key matching 


Keys 

accessing by primary key 

accessing by secondary key 

alternate structure for K2 

alternate structure for K3 

index key fields 

indexed files 

matching criteria entry 

matching sorted 

matching unsorted 

multiple index keys 

Nnonindexed files 

output arranged by K3 

output arranged by primary key 

output arranged by secondary key 

SELECT DATA program with 
alternate structure 

SELECT DATA program with 
duplicate keyed fields 

types of matching critera 

use of matching criteria 

use of sort keys 


LENGTH/TYPE 
alphanumeric fields 
assumed decimal fields 
binary fields 
LENGTH designation 
numeric fields 
packed decimal fields 
specifying data length and type 
TYPE designation 


Library 
definition 
module types 
types 


Reference 


48 
48 
48 


12 


D.2 


6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 
6.7 


6.7 


6.7 
6.7 
6.7 
6.7 


6.6 
6.6 
6.6 
6.6 
6.6 
6.6 
6.6 
6.6 


5.2 
D.7 
5.6 


Page 


D-2 


6-10b 
6-10c 
6-10c 
6-10d 
6-10a 
6-10a 
6-10a 
6-10a 
6-10a 
6-10b 
6-10a 
6-10d 
6-10b 
6-10c 


6-10d 


6-11 

6-10a 
6-10a 
6-10 
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nw ow 
1 
Nahm w 


Term 


SLINE system utility field 


Logging on the system 
how to fog on 
purpose 
when to log on 
workstation display, idle system 


Logical operators 


Lowercase words 
program statement format conventions 
screen format conventions 


Matching criteria 
choosing a type 
entry 
index key fields 
matching criteria with a device 
matching fields 
matching sorted 
matching unsorted 
restrictions 
types 
use 


Matching criteria with a device 


Matching sorted 
restrictions 
structure representation 


Matching unsorted 
restrictions 
structure representation 


Modes of operation 


Nonindexed files 
matching fields 
organization 


Numeric fields 
examples 
length 
sign handling 
structure representation 


Reference Page @ 








D.3 D-4 
2.2 2-3 
2.2 2-2 
2.2 2-2 
2.2 2-2 
7.34 7-4] 
72 7-3 
15 1-13 
6.7 6-10a 
6.7 6-10a 
6.7 6-10a 
6.7 6-12 
6.7 6-12 
6.7 6-12 
6.7 6-12 
6.7 6-12 
6.7 6-10a 
6.7 6-10a 
6.7 6-12 
6.7 

6.7 

6.7 

6.7 


See interactive 
program mode 
and interactive 
tutorial mode. 


6.7 6-1 
6.2 6-2 


6.6 6 

6.6 6- 
6 
6 
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ESCORT 
Reference Page Term Reference Page 
O PRINT JOB command 
named jobs 5.29 5-19 
Operating modes purpose 9.29 5-19 
interactive program mode 1.2 1-4 unnamed jobs 5.29 5-19 
interactive tutorial mode 1.2 1-2 
PRINT JOB NAMES command 5.30 5-19 
Operators 
arithmetic Appendix D PRINT PROGRAM command 
character-string 7.34 7-40 named programs 5.8 5-6 
logical 7.34 7-41 purpose 5.8 5-6 
relational 7.34 -40 unnamed programs 5.8 5-6 
Special system 7.34 7-41 
PRINT PROGRAM NAMES command 5.9 5-6 
Optional parameters and clauses 
program statement format conventions 7.2 7-3 PRINT STRUCTURE command 
screen format conventions 15 1-13 action 5.20 5-15 
purpose 5.20 5-15 
OUTPUT TO clause 
format 7.26 7-31 PRINT STRUCTURE NAMES command 5.21 5-15 
parameters 7.26 7-31 
use 7.26 7-31 Program 
appearance 1.1 1-1 
Overlay fields 6.7 6-15 defined 1.3 1-7 
executing in tutorial mode 3.5 3-9 
saving in tutorial mode 3.5 3-9 
Program commands 
CHANGE PROGRAM 5.4 5-4 
DISPLAY PROGRAM 55 5-5 
DISPLAY PROGRAM NAMES 5.6 5-5 
ENTER PROGRAM 57 5-5 
menu 5.3 5-4 
PRINT PROGRAM 5.8 5-6 
PRINT PROGRAM NAMES 5.9 5-6 
REMOVE PROGRAM FROM LIBRARY 
P command 5.11 5-7 
REMOVE PROGRAM FROM WORKFILE 
Packed decimal fields command 9.10 5-6 
examples 6.6 6-10 result of choosing 14 1-11 
length 66 6-9 RUN PROGRAM 5.12 5-7 
sign handling 6.6 6-9 SAVE PROGRAM 5.13 5-8 
Storage requirements 6.6 6-9 
structure representation 6.6 6-9 Program development 
program mode Fig. 1-1 1-8 
Parentheses, screen format conventions 15 1-13 tutorial mode Fig. 1-2 1-12 
Password commands Program mode See interactive 
description 5.35 5-21 program mode. 
DISPLAY PASSWORDS 5.36 -22 
ENTER OR CHANGE PASSWORDS §.37 5-23 Program mode error messages Appendix E 
REMOVE PASSWORDS OF FILE 5.38 5-23 
PROGRAM NAME, assigning in tutorial mode 3.5 3-7 
PRINT clause 
format 7.27 7-32 Program processing options (tutorial mode) 3.5 3-9 
parameters 7.27 7-32 
use 7.27 7-32 Program statement format conventions 7.2 7-3 
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Term Reference Page Term Reference Page eS 
Program statements Reserved words Appendix B 
CHANGE DATA 7.6 7-8 
clause cross-reference Table 7-1 7-2 RESIDENT program or job 5.2 5-2 
defined 13 1-7 
DELETE DATA 7.14 7-17 Retrieving data See selecting 
ENTER DATA 73 7-4 data. 
format conventions 7.2 7-3 
function 7.1 7-2 RUN JOB command 
SELECT DATA 7.9 7-12 named jobs 5.33 5-20 
SORT DATA 7.12 7-15 purpose 5.33 5-20 
types 71 7-1 unnamed jobs 5.33 5-20 
use in program mode 7.1 7-1 
use in tutorial mode 7.1 7-1 RUN PROGRAM command 
named programs 5.12 5-7 
Purpose of ESCORT 1.1 1-1 purpose 5.12 5-7 
unnamed programs 5.12 5-7 
S 
R SAVE JOB command 
named jobs 5.34 5-21 
Record 6.1 6-1 purpose 5.34 5-21 
unnamed jobs 5.34 5- 
Recover See session 
recovery. SAVE PROGRAM command 
named programs 5.13 5-8 
Relational operators 7.34 7-40 purpose 5.13 5-8 
unnamed programs 5.13 5-9 
REMOVE JOB FROM LIBRARY command 5.32 5-20 
SAVE STRUCTURE command 
REMOVE JOB FROM WORKFILE command 5.31 5-19 action 5.23 
purpose 5.23 
REMOVE PASSWORDS OF FILE command 5.38 5-23 
Screen format 
REMOVE PROGRAM FROM LIBRARY command 5.11 5-7 customized 9.4 9-4 
9.7 9-7 
REMOVE PROGRAM FROM WORKFILE command 5.10 5-6 Appendix G 
default 9.4 9-4 
REMOVE STRUCTURE command 5.22 5-15 tules for screen forms 9.4 9-4 
REPEAT COUNT Screen format conventions 15 1-13 
array fields defined 6.7 
example of array field 6.7 6-14 Screen format coordinator 9.2 9-2 
function 6.7 
referencing array fields in a : Screen format generator 





program 6.7 6-14 calling before entering ESCORT 9.3 9-3 
specifying array fields in a calling during the ESCORT session 93 9~3 
structure 6.7 6-14 function 9.2 9-2 
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Term 


Screen format services 
elements 
how to create a form 


Screen menu method (of program entry) 
advantages 


command choice 
default program name 
entering a program 


program statements selection 

using to create data change programs 
using to create data entry programs 
using to create delete data programs 
using to create select data programs 
using to create sort data programs 


SELECT DATA 
purpose 
selection methods 
using screen menu method 


Select data based on conditions 
additional options 
choosing the select function 
condition specification 
example 
maximum number of conditions 
naming the file 


Select data from the workstation 
clause selection 
displaying data records 
displaying the program 
example program 
initiation of SELECT DATA 
keyed file record selected 
keyed file selection prompt 
parameter keyin 
program compilation 
program execution 
program objective 
required parameters 
saving the program 
SELECT DATA statement 
statement completion 


Select data of one file from another 
example of selecting from another file 
example output 
example setup 
example structures 
files used 
program objective 


Reference 


9.2 
9.2 


1.2 
4] 
43 
43 
12 
4.3 
43 
47 
44 
4.15 
4.11 
4.19 


4.11 
4.11 
4.11 


3.9 


3.9 
3.9 
3.9 
3.9 


4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
4.13 
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4.14 
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4-30 
4-51 


4-30 
4-30 
4-30 


4-38 
4-39 
4-40 
4-40 
4-37 
4-40 
4-40 
4-38 
4-39 
4-40 
4-36 
4-37 
4-40 
4-38 
4-39 


4-42 
4-44 
4-4] 
4-4] 
4-4] 
4-4) 
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Term 


SELECT DATA program statement 
basic format 
basic statement 
format 


other clause 
parameters 
related clauses 


select data from the workstation 
select data of one file from another 
select data with conditions 

use 


Select data with conditions 
building the program 
clause decisions 
example definition 
example program 
example structure 
initiation of SELECT DATA 
parameter keyin 
program compilation 
program display 
program execution 
program output 
required parameters 
saving the program 
statement completion 
using an output screen form 


Selecting data (tutorial mode) 
based on conditions 
data selection methods 
data selection options 


Session file 


Session recovery 
description 
how to ensure ESCORT 
how to recover the session file 


SORT DATA 
nonindexed files 
SORT DATA statement usage 
sort key definition 
sort key usage 
using the screen menu method 
variations of the SORT DATA statement 
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Reference 


7.10 
7.11 
7.10 
714 
A4 
79 
7.11 
79 
711 
4.13 
4.14 
4.12 
79 


4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 
4.12 


3.9 
3.8 
3.8 


5.2 


5.39 
2.3 
2.3 


4.19 
4.19 
4.19 
4.19 
4.19 
4.19 
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4-31 
4-33 
4-30 
4-34 
4-30 
4-32 
4-32 
4-34 
4-34 
4-35 
4-36 
4-32 
4-34 
4-34 
4-31 


3 
3-17 
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4-52 
4-52 
4-52 
4-52 
4-52 
4-52 
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Term 


Sort data by designating field names 
example definition 
example program 
example structure 
initiation of SORT DATA 
parameter keyin 
printing the file 
program compilation 
program display 
program execution 
program results 
required parameters 
SORT DATA statement 
statement completion 


Sort data by matching structure field 
ESCORT action 
example definition 
example program 
example structure 


SORT DATA program statement 
by field names 
clause restrictions 
format 


in tutorial mode 

parameters 

sort data by designating field names 
sort data by matching structure field 
uses 


Sorting data 
by field names 
option selection 
purpose of SORT DATA 
SORT DATA options 


Sorting data by field names 
choosing SORT DATA 
entering sort criteria 
example 
specifying sort criteria 


Sorting sequence 


Special system operators 
ENDOFILE operator 
FIRSTIME operator 


START POSITION 
example 
overlay field 
use 


Reference 


4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 
4.20 


4.21 
4.21 
4.21 
4.21 


3.11 
7.12 
7.13 
AS 

3.10 
7.13 
4.20 
4.21 
7.12 


3.11 
3.10 
3.10 
3.10 


3.11 
3.11 
3.11 
3.11 
0.6 

7.34 
7.34 
6.7 


6.7 
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ESCORT 
ee 


Term 


Statement format conventions 
program statements 
screens 


Statement formats 
CHANGE DATA 


DELETE DATA 
ENTER DATA 
SELECT DATA 


SORT DATA 


Structure 
building 
command selection menu 
completed structure screen 
defined 


ENTER STRUCTURE screen 
entering 


function of structure statements 
HELP facility 

HELP screen 

keying in changes 

making changes permanent 

moving from field to field 

optional parts of structure statement 
processing the structure 

required parts of structure statement 


STRUCTURE COMMANDS menu 
structure statement makeup 
using commands to manipulate 


Structure commands 
CHANGE STRUCTURE 
DISPLAY STRUCTURE 
DISPLAY STRUCTURE NAMES 
ENTER STRUCTURE 
INSERT INTO STRUCTURE 
menu 
PRINT STRUCTURE 
PRINT STRUCTURE NAMES 
REMOVE STRUCTURE 
result of choosing 
SAVE STRUCTURE 


Structure error messages 
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15 


9.15 
5.16 
5.17 
5.18 
5.19 
5.14 
5.20 
5.21 
5.22 
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9.23 
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& Term Reference Page Term Reference Page 
Structure/form linkup T 
default screen format for example 9.5 9-5 
example form 9.5 9-5 TERMINATE CURRENT ESCORT SESSION 
example structure 9.5 9-5 JOB command 5.39 5-24 
program example 9.5 9-6 
TOTALING clause 
Structure statements format 7.29 7-35 
defined 1.3 1-7 parameters 7.29 7-35 
EDIT CODES 6.7 6-13 use 7.29 7-35 
FIELDNAME 6.6 6-6 
function 6.5 6-5 Tutorial mode See interactive 
KEYS 6.7 6-10a tutorial mode. 
LENGTH/TYPE 6.6 6-7 
makeup 6.5 6-5 
optional parts 6.5 6-5 
6.7 6-10a 
REPEAT COUNT 6.7 6-13 
required parts 6.5 6-5 
6.6 6-6 
START POSITION 6.7 6-14 
SUBTOTALING clause 
example structures 7.28 7-33 
format 7.28 7-33 
parameters 7.28 7-33 
& subtotaling program example 7.28 7-34 
subtotaling program output 7.28 7-34 
use 7.28 7-33 U 
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